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MANUAL vs. AUTOMATIC TRANSMISSIONS 
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WHY BUY MANUAL? 

• ECONOMICAL 

(MINIMUM I CAN BUY THE CAR WITH) 

(I CAN SAVE ON GAS, IF I DON'T ABUSE IT) 

(I DON'T NEED A BATTERY TO START THE CAR) 

• PERFORMANCE 

(I AM A RACE CAR DRIVER) 

(TERRAIN CALLS FOR IT, MOUNTAINOUS, HILLS. .. .ETC. ) 

t- : / 

• DISADVANTAGE 

(NEED A SKILLED DRIVER) 
(HAVE TO DO MORE WORK) 
(CAN'T HOLD ON TO "PERSON" FRIEND WHILE DRIVING) 



WHY BUY AUTOMATIC? 

• LAZY 
(LESS WORK, NO PUSHING CLUTCH, NO CHANGING GEARS) 

• SKILL 
(DON'T NEED TO WORRY ABOUT ROLLING DOWN HILLS) 



• DISADVANTAGE 

(COSTS MORE) 
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A CLOSER LOOK 
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AUTOMATIC 



MANUAL 




THE MANUAL OR "BASIC" 
TRANSMISSION 



THE MANUAL TRANSMISSION 
IS "EXTENDED" BY ADDING 
SOME "STUFF" TO IT 



V 
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SPEAKING OF BASIC AND EXTENDED 
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CHAPTER 1 
RMX 86 BASIC I/O SYSTEMS 

-An Applications Programmer's View 

• FILES 

• FILE CLASSES 

• I/O OPERATIONS 

• HIERARCHICAL FILE STRUCTURES 

• FILE CONNECTION 



MANUAL 
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PROGRAMMING ROLES 
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THERE ARE TWO PROGRAMMING ROLES ASSOCIATED WITH 
THE IRMX 86 OPERATING SYSTEM. 



THE APPLICATION PROGRAMMER USES SYSTEM CALLS 
AND OBJECTS THAT AFFECT ONLY HIS OWN JOB 




THE SYSTEM PROGRAMMER CONTROLS SYSTEM 
RESOURCES AND CHARACTERISTICS 



V 
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I/O COMMUNICATION 



• THROUGH RMX 86 I/O SYSTEMS, TASKS COMMUNICATE WITH EACH OTHER 
AND THE EXTERNAL WORLD. 



WINNIE 



FLOPPY 



V. 



I 




o 



I 






^("ssr jnO 




1-2 



r 



COMMUNICATION 
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• TASKS MAKE "SYSTEM CALLS" TO THE BIOS TO COMMUNICATE 
WITH THE FILE 



/ 


/ 






TASK 


CALL READ __ 


I/O 
SYSTEM 


/ 









FLOPPY 

o 



V 
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RMX I/O IS DONE TO/FROM FILES 
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12 3 4 5 6 



5. 
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- A FILE IS AN UNBOUNDED SEQUENCE OF COMPONENTS 

- FILES ARE USED FOR 

- LONG TERM STORAGE 

- TEMPORARY DATA STORAGE EXPANSION 
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THE FILE 
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FILES HAVE A FILE POINTER 



V 



BEGINNING 



V 



FILE 



FILE POINTER 



END 



J 
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CLASSES OF FILES 



t PHYSICAL FILE - CONTINUOUS SEQUENCE OF BYTES ON A DEVICE WHERE NO 
FILE STRUCTURE IS IMPOSED (E.G., PRINTER, TERMINAL) 



• STREAM FILE - MEMORY BASED BYTE STREAMS. DESTRUCTIVE-READ 
SERVES COMMUNICATION BETWEEN TASKS 



• NAMED FILE - DATA FILES RESIDING ON RANDOM ACCESS STORAGE DEVICES, 
ACCESSED VIA ASCII NAMES (E.G., FLOPPY DISK, HARD 
DISK). 
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ACCESSING NAMED FILES 
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OPEN 
FILE 



READ- 



WRITE 



SEEK 



CLOSE 
FILE 
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OPEN 



AFTER A FILE CONNECTION HAS BEEN ESTABLISHED, THE RQ$A$OPEN" 
SYSTEM CALL OPENS A FILE FOR I/O OPERATIONS 

• OPEN FILE COMMANDS 
READ 
WRITE 
SEEK 



• THE RQ$A$OPEN SPECIFIES 

- A FILE MAY BE 

READ ONLY 
WRITE ONLY 
READ OR WRITE 

- TYPE OF SHARING DESIRED 

READERS 
WRITERS 
ALL 



>, 



V 
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f OPENING A FILE * 



V 



CALL RQ$A$OPEN (FILE$CONNECTIQN$TOKEN, MODE, SHARE, RESP$MBOX,aSTATUS; 



MODE: MODE OF ACCESS DESIRED 

VALUE MODE 



1 


OPEN FOR READING 


2 


OPEN FOR WRITING 


3 


OPEN FOR READING AND WRITING 



SHARE: KIND OF SHARING DESIRED 



PRIVATE USE ONLY 

1 SHARE WITH READERS ONLY 

2 SHARE WITH WRITERS ONLY 

3 SHARE WITH ALL USERS 
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THE RQ$A$READ SYSTEM CALL 

• READ 'COUNT' BYTES FROM AN OPEN FILE INTO THE BUFFER 

• BYTES ARE READ STARTING AT FILE POINTER 

CALL RQ$A$READ (FILE$CONNECTION$TOKEN, aBUFFER, COUNT, RSPIMBOX, aSTATUS); 



V 
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THE RQ$A$WRITE SYSTEM CALL 



• WRITE ANY NUMBER OF BYTES FROM A USER BUFFER 
INTO AN OPEN FILE 



• THE DATA IS WRITTEN BEGINNING AT THE CURRENT SETTING 
OF THE FILE POINTER 



CALL RQ$A$WRITE (FILE$CONNECTION$TOKEN, 3BUFFER, COUNT, RESPIMBOX, aSTATUS); 



V. 



V. 
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THE RQ$A$SEEK SYSTEM CALL 

• MOVES THE FILE POINTER TO ANY BYTE POSITION IN THE OPEN FILE 

• HI$PTR$MOVE, LOW$PTR$MOVE = WORD PAIR CONTAINING A 32-BIT 
UNSIGNED NUMBER 



CALL RQ$SEEK (FILE$CONNECTION$TOKEN,MODE,PTR$MOVE,RESP$MBOX,aSTATUS); 



MODE ACTION BY POINTER 

1 BACKWARD BY PTR$MOVE (RELATIVE 

2 EQUAL TO PTRIMOVE (ABSOLUTE) 

3 FORWARD BY PTR$MOVE (RELATIVE) 

4 TO EOF MINUS PTR$MOVE (ABSOLUTE) 
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THE RQ$A$CLOSE SYSTEM CALL 
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• CLOSES AN OPEN FILE CONNECTION 

• A FILE CONNECTION IS CLOSED BY THE APPLICATION PROGRAMMER 

- WHEN I/O OPERATIONS ARE COMPLETE 

- WHEN THE MODE OR SHARED STATUS IS TO BE CHANGED 



CALL RQ$A$CLOSE (FILE$CONNECTION$TOKEN,RESP$MBOX, EXCEP$PTR). 



V 
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BIOS I/O ASYNCHRONOUS 



A 



• EACH I/O OPERATION (OPEN, READ, WRITE, SEEK, CLOSE) SHOULD BE 
FOLLOWED BY A "STATUS CHECK" .{HANDSHAKE ) 



TASK 



BASIC I/O 



OPEN 
RECEIVE 

READ 
RECEIVE 

SEEK 
RECEIVE 

READ 
RECEIVE 



■(IORS) 



•(IORS) 



•(IORS) 



(IORS) 
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RESULT OF I/O OPERATION CALLS 

• THE PROGRAM MAY RECEIVE AN I/O RESULT SEGMENT* (IORS) 

AFTER A FILE ACCESS CALL. 

*SEE BASIC I/O REFERENCE MANUAL FOR A DESCRIPTION OF 
THE IORS STRUCTURE. 

• • THE PROGRAM WAITS AT THE RESPONSE MAILBOX SPECIFIED 
IN THE CALL. 

• AFTER EXAMINING THE STATUS FIELD IN THE IORS THE PROGRAMMER 
MUST DELETE THE SEGMENT. 

• IF THE RESPONSE MAILBOX PARAMETER IN THE CALL EQUALS 

THEN NO IORS WILL BE RETURNED BY THE I/O SYSTEM. (NOT RECOMMENDED) 



V 
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EXAMPLE ACCESS CALL 

CALL RQ$A$READ (FILE$CONNECTION$TOKEN, aBUFFER, 80, RSPIMBOX, aSTATUS); 
IF STATUS <>E$OK THEN CALL ERROR; /'SYNCHRONOUS PART*/ 

OVERLAPPED PROCESSING 



IORS$TOKEN = RQ$RECEIVE$MESSAGE (RSP$MBOX, . . . .,aSTATUS); 
IF STATUSOEIOK THEN CALL ERROR; /'SYNCHRONOUS PART*/ 

IF I0RS.STATUSOE$0K THEN CALL ERROR: /'ASYNCHRONOUS PART*/ 
CALL RQ$DELETE$SEGMENT (IORS$TOKEN,aSTATUS); 
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THE EASY WAY! 
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• FOR READ, WRITE , AND SEEK WE MAY USE THE RQ$WAIT$IO SYSTEM CALL 

• THE FORM OF THE CALL IS 



ACTUAL = RQ$WAIT$IO(CONN$T,RSPMBOX,TIMELIMIT,aSTATUS); 



• BASIC I/O DEALS WITH IORS'S DIRECTLY 

- EFFICIENT BECAUST IT KEEPS A SUPPLY OF IORS'S AVAILABLE 

- USER TASKS DO NOT HAVE TO DELETE THE IORS 
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FILE CONNECTION 



FILE ACCESS 



CREATE FILE 

OR ATTACH 

FILE 




rED-i 



Hj^^S-tGE}-- 



*• XU -i 



DELETE CONN 
DELETE FILE 
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FILE ATTACH 

• IF THE FILE ALREADY EXISTS THEN THE USER MAKES AN "ATTACH$FILE" 
SYSTEM CALL. 



"\ 



CALL RQ$A$ATTACH$FILE (USER$TOKEN, PREFIX, SUBPATH, . , ..aSTATUS), 



V 



SEE BASIC I/O REFERENCE MANUAL FOR DETAILS. 



CALL RQ$A$ATTACH$FILE (USERIOBJECT, DEVICE$CONNECTION$TOKEN, 
3(25, 'SERVICE/TUNEUP/TUNESCHED'), RSP$M.BOX, aSTATUS); 



• THE USER$TOKEN WILL BE DISCUSSED IN NEXT CHAPTER. 
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J I DIRECTORIES 
/\ DATA FILES 
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PATHNAMES 



• PATHNAMES ARE SPECIFIED BY A PREFIX AND A SUBPATH 



PREFIX - TOKEN FOR AN EXISTING DEVICE CONNECTION OR FILE CONNECTION 



- SPECIFIES THE STARTING POINT IN A DIRECTORY TREE SCAN 
SUBPATH - ASCII STRING DESIGNATING THE REST OF THE PATH 



E.G. - PREFIX 
- SUBPATH 



DEVICE$CONNECTION$TOKEN 

3(25, 'SERVICE/TUNEUPS/TUNESCHED') 
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FILE CREATION 



• TO CREATE A FILE THE USER MAKES A "CREATE$FILE" SYSTEM CALL 



CALL RQ$A$CREATE$FILE (USER$TOKEN, PREFIX, SUBPATH, . . 3STATUS). 



SEE BASIC I/O REFERENCE MANUAL FOR DETAILS ON PARAMETERS 



A 



V 
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RESULT OF FILE CONNECTION 



V. 



• THE PROGRAMMER MUST WAIT AT THE RESONSE MAILBOX SPECIFIED IN THE 
CREATE$FILE OR ATTACH$FILE SYSTEM CALL. 



CALL RQ$A$ATTACH$FILE ( , , , RSP$MBOX, 3STATUS); 



FILE$CONNECTION$TOKEN = RQ$RECEIVE$MESSAGE (RSP$MBOX, , , aSTATUS); 



• SUCCESSFUL CONNECTION RETURNS FILE CONNECTION TOKEN (TYPE = 101H) 

• UNSUCCESSFUL CONNECTION RETURNS SEGMENT TOKEN (TYPE = 6) 

- THE SEGMENT RETURNED IS AN IORS 

- THE PROGRAMMER MUST DELETE THE IORS AFTER EXAMINING THE STATUS FIELD 
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EXERCISE (OPEN MANUAL) 

• HOW LONG CAN AN ASCII NAME IN A SUBPATH BE? 

• DESCRIBE PICTORIALLY AN IORS. 

• FILL IN THE ELLIPSES: 



CM 



>v 



t A PREFIX CAN BE A 









OPEN 

READ 

WRITE 

SEEK 

CLOSE 




Y 


CREATE 
ATTACH 


-T^ 


— *- 





















R A 
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CHAPTER 2 
RMX 86 BASIC I/O SYSTEM 

-A System Programmer's View 



t DEVICE CONNECTION 

• PHYSICAL ATTACHMENT 

• USER OBJECT 

• FILE ACCESS LIST 

• SUMMARY 



r 
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DEVICE CONNECTION 

• DEVICE CONNECTION AND USER TOKEN IS A "SYSTEM PROGRAMMERS" 
RESPONSIBILITY. 



CREATE 
USER 



PHYSICAL 
ATTACH 
DEVICE 



SYSTEM 
PROGRAMMER 




u v- 



FILE ACCESS 



-*LmJT "L^Lr tGSlH' 



IejJ 



DELFTE CONtl 
DELETE FILE 



APPLICATION 
PROGRAMMER 
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LAYERS 



• THE BASIC I/O SYSTEM HAS TWO LAYERS OF SOFTWARE MODULES 
SUPPLIED BY INTEL: 

- FILE DRIVER INTERFACE 

- DEVICE DRIVER INTERFACE 



FILE 'I 
DRIVERS/ 



PHYSICAL 



NAMED 



JC 



DEVICE 

DRIVERS 71 F1 -OPPY 



WINCHESTER 



BUBBLE 





s 


7 
) 




STREAM 










STREAM 




USART 



^ 
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PHYSICAL ATTACHMENT 

• AT RUN TIME THE FILE DRIVER IS "PHYSICALLY ATTACHED" TO THE 
DEVICE DRIVERS THROUGH I/O SYSTEM CALLS 




MORE ^ | 
DEVICE > 



FILE DRIVERS DRIVERS 






J = 



DEVICES 



"\ 
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INTEL SUPPLIED DEVICE DRIVERS. 
• THE BASIC I/O SYSTEM SUPPORTS SEVERAL DEVICES 

- SOME EXAMPLES - 



DEVICE CONTROIIFR 


DEVICE DRTVFR 


'NAMF' 


iSBC 204 SS/128 UNIT 


'F0' 




iSBC 204 SS/512 UNIT 


'FX0' 




iSBC 208 DS/256 UNIT 


'AFDD0' 




iSBC 215/218 PRIAM 3450 UNIT 


'IW0' 




iSBC 215/218 DS/256 FLOPPY UNIT 


'WFDD0' 




LINE PRINTER 


'LP' 




USART 


• 'T0' 


J 
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PHYSICAL ATTACHMENT 



CALL RQ$A$PHYSICAL$ATTACH$DEVICE (DRV$NAME, FILE$DRIVER, RESP$MBOX, aSTATUS); 



V 



t A SUCCESSFUL "PHYSICAL ATTACH DEVICE" RETURNS A DEVICE CONNECTION 
TOKEN (TYPE = 101H) 

• AN UNSUCCESSFUL CONNECTION RETURNS A SEGMENT TOKEN (TYPE = 6) 

- THE STRUCTURE OF THE SECMENT IS AN I/O REQUEST/RESULT SEGMENT 
(IORS) 



EXAMPLE 

CALL RQ$A$PHYSICAL$ATTACH$DEVICE(3(2, 'F0'), 4,RESP$MB0X,3STATUS); 

• OVERLAPPED PROCESSING MAY OCCUR HERE) 
DEVICE$CONNECTION$TOKEN = RQ$RECEIVE$MESSAGE(RESP$MBOX,0FFFFH, aRESP, aSTATUS). 
/* TEST FOR VALID CONNECTION OBJECT */ 

TYPE$TOKEN - RQ$GET$TYPE(DEVICE$CONNECTION$TOKEN, aSTATUS); 
IF TYPE$TOKEN < > 101H THEN ERROR; 



V 
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BASIC I/O SYSTEM CALLS FOR FILES 



SYSTEM 
PROGRAMMER 

CREATE$(JSER 
PHYSICAL$ATTACH$DEVICE 




APPLICATION 
PROGRAMMER 



CREATE$FILE OR ATTACH$FILE 

OPEN 

READ 

SEEK } FIL E 

WRITE ■ ACCESS 

CLOSE 
DELETE$CONNECTION OR 
DELETE$FILE • 



PHYSICAL$DETACH$DEVICE 
DELETE$USER 
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BASIC I/O EXERCISE 

1) WRITE THE CODE NECESSARY TO WRITE A STRING OF DATA TO A FILE 
ON A SBC204 SD/SS FLOPPY 

* GIVEN 

- THE FLOPPY HAS ALREADY BEEN FORMATTED 

- THE NAME OF THE DEVICE IS F0 

- THE NAME OF THE FILE IS 'COMPANY/EMPLOYEE/PERSONAL' 

- THE FILE ALREADY EXISTS 

- THE DATA TO BE WRITTEN AT THE END OF THE FILE 

- THE DATA IS 'L. JONES, 5050 MAIN DRAG, 3710217' 



2-8 



r 



CONTROLLED ACCESS 



• ONLY "NAMED FILES" PROVIDE CONTROLLED ACCESS TO FILES. 



"\ 



CONTROL IS ACCOMPLISHED BY COMPARISON OF A USER IDISTRUCTURE 



AND A FILE ACCESS LIST. 
USER 1 



USER 2 



ID1 



ID2 



USER 3 



ID3 



ID2 
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FILE ACCESS LIST 



ID1 


ALL 


TD? 


RFAD ONI Y 


ID3 


WRITE ONLY 
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THE USER ID STRUCTURE 
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• IDENTIFYING INFORMATION ABOUT A USER (JOB OR HUMAN) 

• EACH ID$STRUCTURE CONTAINS AN ARRAY OF 16 BIT VALUES CALLED ID'S 
t THE FIRST ID IN THE ARRAY IS CALLED THE OWNER ID 

• THE REMAINING ID'S DEFINE THE GROUPS OF WHICH THE USER IS A MEMBER OF 



ID$STRUCTURE 



""•* Vrt-* 1'^UJ^' 


., '■■'ZztU? 


B'iXQ -315U 

^Bi.i;7 09/31 







OWNER ID 



ID 



ID 



ID 



»^^^^^ 
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USER TOKEN CREATION 



• TO CREATE A USER TOKEN THE "SYSTEM PROGRAMMER" MAKES A CALL 
TO THE O.S. IN THE FORM 



"\ 



USER$TOKEN = RQ$CREATE$USER OID$STRUCT, aSTATUS); 



t E.G. 



V 



DECLARE IDISTRUCT STRUCTURE (LENGTH WORD, 

COUNT WORD, 
IDC) WORD). 
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FILE ACCESS LIST 



• A COLLECTION OF UP TO 3 PAIRS OF OWNER ID'S AND ACCESS MASKS 



• THE ID'S REPRESENT USERS OR GROUP OF USERS 



t THE ACCESS MASK REPRESENTS THE KINDS OF ACCESS TO THE FILE 
THAT THOSE USERS OR GROUPS OF USERS ARE ALLOWED 



ACCESS 
LIST 



OWNER ID #1 


ACCESS 
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• THE ACCESS LIST BELONGS TO THE FILE 
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ACCESS LIST CREATION 

TASKS CALLING CREATEIFILE PASS AN ACCESS MASK AND A USER$TOKEN 

• THE I/O SYSTEM PAIRS THE "OWNER ID" AND "ACCESS MASK" AND 
APPENDS THE PAIR TO THE FILE ACCESS LIST 



V 



CALL RQ$CREATE$FILE (USER$TOKEN, , .ACCESS, . . .); 



USER 

ID 

STRUCTURE 



rwrnn 



ID 



ID 



ID 


ACCESS 











FILE 

ACCESS 

LIST 



• ACCESS IS ALSO IMBEDDED IN THE FILE CONNECTION TOKEN RETURNED 
TO THE CALLING TASK VIA THE RESPONSE MAILBOX 
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ADDING ID'S TO THE ACCESS LIST 



A 



• THE RQ$A$CHANGE$ACCESS SYSTEM CALL WILL CHANGE THE ACCESS 
RIGHTS TO A NAMED DATA OR DIRECTORY FILE. 

• THE ID AND ACCESS SPECIFIED IN THE CALL WILL BE ADDED 
TO THE ACCESS LIST IF THE ID IS NOT FOUND IN THE LIST. 

t THE FORM OF THE CALL IS 



CALL RQ$A$CHANGE$ACCESS (USER$TOKEN,. . . ,ID, ACCESS,...) 
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COMPUTATION OF ACCESS DURING ATTACH FILE 

• THE I/O SYSTEM COMPARES THE ID'S IN THE USER ID STRUCTURE 
WITH THE ID'S IN THE ACCESS LIST. 

• THE ACCESS MASKS CORRESPONDING TO MATCHING ID.'S ARE LOGICALLY 
COMBINED, FORMING AN AGGREGARE MASK WITH COMBINED RIGHTS. 



USER ID STRUCTURE 



ACCESS LIST 



JUL 



ID6 



JUL 



JUL 



JDL 




ID1 



ID3 



Mm. 



WRITE 



Z^^W 



READ OR WRITE 



V. 



• THE COMPUTED ACCESS IS IMBEDDED IN THE FILE CONNECTION TOKEN 
RETURNED TO THE CALLING TASK VIA THE RESPONSE MAILBOX. 



2-15 



LABS 



******* LAB ONE (BASIC 10 SYSTEM) ******* 
OBJECTIVES: 

EXECUTE A STUDENT BASIC 10 APPLICATION JOB IN AN RMX86 O.S. ENVIROMENT 

INTRODUCE (BIOS) SYSTEM CALLS: 

- RQ$A$PHYSICAL$ATTACH$DEVICE 

- RQ$A$CREATE$FILE 

- RQ$A$OPEN 

- RQ$A$READ 

- RQ$A$SEEK 

- RQ$A$WRITE 

- RQ$A$CLOSE 

- RQ$WAIT$IO 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED START. P86 

- A SOURCE FILE NAMED BI0LAB.P86 

COMPILE (PLM86), LINK, AND LOCATE AN APPLICATION JOB, THAT WILL CALL UPON 
THE BIOS TO COMMUNICATE WITH A TERMINAL AND A FILE IN A FLOPPY 



STEP1: 



USE THE ATTACH$FILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME "/LABI) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAME'VLABl AS :LAB: 
* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 

LAB 1 





(APPLI 


CATION) 






STARTl 
TASK 




BIOLAB 
TASK 















LAB OBJECTIVE 

• Use Basic 10 System Calls 

• Read and write from/to a terminal & a floppy 

• The student will be given the nucleus, BIOS and SOB 
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******* LAB ONE (BASIC 10 SYSTEM) ******* 

STEP2: 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB:BI0LAB.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:BI0LAB.P86 

* THIS SOURCE FILE IS THE APPLICATION TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 

CREATE A BUFFER */* LENGTH=80 

CREATE A RESPONSE MAILBOX */* FIFO , HIGH PERFORMANCE 

PHYSICAL ATTACH TO DEVICE */* (3(2,'T0') , PHYSICAL , *N0TE1 

PHYSICAL ATTACH TO DEVICE */* @(5, 'WFDDO' ) , NAMED , *N0TE1 

CREATE FILE CONNECTION TO TERMINAL */* *N0TE1 

CREATE A USER TOKEN */* IDS=(2,2,0000H,0FFFFH) 

CREATE FILE- CONNECTION TO FLOPPY */* (3(8, "LABIDATA* ) , *N0TE1 

OPEN TERMINAL FILE */* (R/W) , SHARE ALL , *N0TE2 

OPEN FLOPPY FILE */* (R/W) , SHARE ALL , *N0TE2 

WRITE READY MESSAGE TO TERMINAL */* (USE RQ$WAIT$IO) 
•ACTUAL = 80; 

DO WHILE ACTUAL GREATER THAN 2 

READ FROM TERMINAL */* (USE RQ$WAIT$IO) 
WRITE TO FLOPPY */* (USE RQ$WAIT$IO) 
SEEK TO EOF MINUS ACTUAL */* fUSE RQ$WAIT$IO) 
READ FROM FLOPPY */* (USE RQ$WAIT$IO) 
WRITE TO TERMINAL */* (USE RQ$WAIT$IO) 

CLOSE TERMINAL FILE */* *N0TE2 

CLOSE FLOPPY FILE */* *N0TE2 

** DELETE SELF ** 

*N0TE1: WAIT FOR CONNECTION AND VALIDATE 

*N0TE2: WAIT FOR IORS , VALIDATE IORS. STATUS , AND DELETE SEGMENT 

THE SOURCE CODE SUPPLIED DOES NOT VALIDATE CONNECTIONS OR IORS'S 
THE STUDENT MAY WISH TO IMPLEMENT THIS FUNCTIONALITY WHEN MODIFYING 
THE SOURCE CODE 
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******* LAB ONE (BASIC 10 SYSTEM) ******* 
STEP3: 

* ROOT JOBS ABSOLUTELY ADDRESS THE STARTING LOCATION OF THE STUDENT'S 
JOB CODE. THE ENTRY POINT MAY VARY IF INTERNAL PROCEDURES OR 
CHARACTER CONSTANTS ARE USED. 

FOR THIS REASON IT IS ADVISABLE TO CREATE AND LINK A START TASK TO 
THE REST OF THE APPLICATION CODE TO FIX THE ENTRY POINT'S OFFSET 
INTO THE CODE 

* THIS APPLICATION JOB WILL BE A FIRST LEVEL JOB, THIS REQUIRES 
THAT A TASK WITHIN THIS JOB MAKE A CALL TO RQ$END$INIT$TASK 
TO RESUME THE ROOT TASK 

* IN ORDER TO DEBUG OUR CODE BEFORE IT "CRASHES" WE MAY WISH TO 
INVOKE THE 957 MONITOR AT THE START OF OUR JOB'S EXECUTION. 

THIS CAN EASILY BE ACCOMPLISHED BY PLACING A "CAUSE$INTERRUPT(3)" 
INSTRUCTION AT THE BEGINNING OF OUR CODE (IN OUR START TASK). 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB: START. P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB: START. P86 

* THIS SOURCE FILE IS THE START TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 



CALL RQ$END$INIT$TASK 

CAUSE$INTERRUPT(3) 

CREATE THE "COMMON$ENTRY" TASK */* PRI=155 , STACKSIZE = 512 

** DELETE SELF ** 
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******* LAB ONE (BASIC 10 SYSTEM) ******* 
5TEP4: 

COMPILE THE SOURCE FILES (START. P86 AND BI0LAB.P86) 

- PLM86 : LAB: START. P86 

- PLM86 :LAB:BI0LAB.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE FOR EACH OF 
THE SOURCE FILES: 

- A LIST FILE NAMED M :LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED ": LAB: (SOURCE) .OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 :LAB:START.OBJ,& 
:LAB:BIOLAB.OBJ,& 
/RMX5.0/DUTILS/EPIFL.LIB,& 
/RMX5.0/DUTILS/IPIFL.LIB,& 
/RMX5.0/DUTILS/RPIFL.LIB & 

TO :LAB:JOB.LNK & 
NOMAP 

LOCATE THE LINKED MODULE TO AN' ABSOLUTE ADDRESS 

L0C86 :LAB:JOB.LNK & 

TO : LAB: LAB JOB & 
SCO) SEGS IZE( STACK (0)) & 
ORDER(CLASSES(CODE, DATA, STACK)) & 
ADDRESSES(CLASSES(C0DE(1040H))) & 
NOINITCODE & 
OC(PURGE) 

AND FINALLY ADD THE LOCATED MODULE TO THE OTHER PRECONFIGURED 
PARTS OF OUR SYSTEM 

LIB86 

DELETE : LAB : RMX86 ( STARTMOD ) 

ADD : LAB: LAB JOB to :LAB:RMX86 

EXIT 

* IN THE LINKING PROCESS OBSERVE THAT WE LINKED THE START MODULE FIRST 

* !!! NO WARNINGS OR ERRORS DURING LINK 

* !!! SOME WARNINGS ARE OK DURING LOCATE (SEE INSTRUCTOR) 

* :LAB:RMX86 IS A "GIVEN" FILE THAT CONTAINS: 

- A PRECONFIGURED NUCLEUS 

- A PRECONFIGURED BIOS 

- A PRECONFIGURED SDB 

- A PRECONFIGURED ROOT JOB 

* THE STUDENT MAY "OPTIONALLY" USE A "GIVEN" SUBMIT FILE THAT WILL 
COMPILE , LINK , LOCATE AND ADD THE FINAL MODULE TO THE SYSTEM 

- SUBMIT :LAB:JOB.CSD 2 _ ig 



******* LAB ONE (BASIC 10 SYSTEM) ******* 
STEP5: 

* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /"TEAM NAME "/LABI /RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 
( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT' ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

* GOOD LUCK...! 
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CHAPTER 3 



RMX 86 EXTENDED I/O SYSTEM 



-An Application Programmer's View 



t WHY USE EIOS? 

t ACCESSING NAMED FILES 

t EIOS BUFFERING 

• FILE CREATION 



AUTOMATIC 




r 



WHY USE THE EXTENDED I/O SYSTEM? 



"\ 




V 



• REDUCE DEVELOPMENT COST 

• AUTOMATIC BUFFERING 

• SYNCHRONOUS SYSTEM CALLS 

• FREES PROGRAMMER FROM TEDIOUS DETAILS 
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SYNCHRONOUS LEVEL I/O OPERATIONS (EIOS) 



A 



• PROGRAMMER DOES NOT HAVE TO USE RESPONSE MAILBOXES 

• SYSTEM CALLS REQUIRE FEWER PARAMETERS 

• NEED TO CHECK ONLY ONE STATUS AFTER THE CALL 




JfciN 
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EIOS MEMORY REQUIREMENTS 



• THE EIOS REQUIRES 12K BYTES ABOVE THE BIOS 




hP^@ 
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' EIOS OPERATIONS * 



V 



AFTER A FILE CONNECTION HAS BEEN ESTABLISHED, 
THE RQ$S$OPEN SYSTEM CALL OPENS A CONNECTION 
FOR I/O OPERATIONS. 

• THE RQ$S$OPEN SPECIFIES 

- A FILE MAY BE 

READ ONLY 
WRITE ONLY 
READ OR WRITE 

- NUMBER OF BUFFERS DESIRED 

• COMMANDS ON OPEN FILES 

READ 

WRITE 

SEED 



r 
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OPENING A FILE 
CALL RQ$S$OPEN <FILE$CONNECTION$TOKEN, MODE, NUM$BUF,aSTATUS). 

MODE: MODE OF ACCESS DESIRED 

VALUE MODE 

1. OPEN FOR READING 

2 OPEN FOR WRITING 

3 OPEN FOR READING AND WRITING 

• CONTROL IS RETURNED ONLY AFTER I/O HAS BEEN PERFORMED. 
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THE RQ$S$READ$MOVE SYSTEM CALL 

ALLOWS READING FROM AN OPEN FILE 

• COUNT BYTES ARE READ STARTING AT FILE POINTER 



ACTUAL = RQ$S$READ$MOVE (FILE$CONNECTION$TOKEN, aBUFFER, COUNT, aSTATUS), 
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THE RQ$S$WRITE$MOVE SYSTEM CALL 



">i 



• ENABLES ANY NUMBER OF BYTES TO BE WRITTEN 
FROM A USER BUFFER INTO AN OPEN FILE 

• THE DATA IS WRITTEN BEGINNING AT THE CURRENT 
SETTING OF THE FILE POINTER 

| ACTUAL ■ RQ$S$WRITE$MOVE (FILE$CONNECTION$TOKEN, aBUFFER, COUNT, aSTATUS); 
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EIOS BUFFERING 



• THE EIOS PROVIDES AUTOMATIC BUFFERING OF I/O OPERATIONS 
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BUFFERING METHODS 



• ONE BUFFER ONLY 

- THE EIOS WILL WRITE OR READ INFORMATION ONE BUFFER AT 
A TIME (BLOCKING). 

• TWO OR MORE BUFFERS 

- ALLOWS BLOCKING AND OVERLAPPED I/O BY USING READ-AHEAD, 
WRITE-BEHIND ALGORITHMS. 

• ZERO BUFFERS 

- THE EIOS WILL ACCESS THE FILE EACH TIME THE APPLICATION 
READS OR WRITES TO THE FILE. 



A 
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THE RQ$S$SEEK SYSTEM CALL • 

• MOVES THE FILE POINTER FOR AN OPENED FILE 
TO ANY BYTE POSITION IN THE FILE 

• HI$PTR$MOVE, LOW$PTR$MOVE = 
WORD PAIR CONTAINING A 32-BIT UNSIGNED NUMBER 



CALL RQ$S$SEEK (FILE$CONNECTION$TOKEN, MODE, HI$PTR$MOVE, LOW$PTR$MOVE, 3STATUS); 



V. 



MQDE ACTION BY POINTER 

1 BACKWARD BY PTR$MOVE (RELATIVE) 

2 EQUAL TO PTR$MOVE (ABSOLUTE) 

3 FORWARD BY PTR$MOVE (RELATIVE) 

4 TO EOF MINUS PTR$MOVE (ABSOLUTE) 



V. 
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THE RQ$S$CLOSE SYSTEM CALL 

• CLOSES AN OPEN FILE CONNECTION 

• A FILE CONNECTION IS CLOSED BY THE PROGRAMMER 

- IF I/O OPERATIONS ARE COMPLETE 

- IF THE OPEN MODE OR SHARED STATUS IS TO BE CHANGED 



CALL RQ$S$CLOSE (FILE$CONNECTION$TOKEN, EXCEPT$PTR); 
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EXAMPLE 

ACTUAL = RQ$S$READ$MOVE (FILE$CONNECTION$TOKEN, aBUFFER, 80, 3STATUS); 
IF STATUS < >0 THEN CALL ERROR; 



• THE 


USER ONLY NEEDS 


TO CHECK STATUS 




• AFTER RETURNING 


FROM 


THE CALL THE BUFFER 


WILL CONTAIN 


THE 


INFORMATION 









V 
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EIOS FILE CREATION 



• TO CREATE A FILE THE USER MAKES A "CREATE$FILE" SYSTEM CALL 



FILE$CONNECTION$TOKEN = RQ$S$CREATE$FILE (PATH$PTR, aSTATUsT] 



SEE EIOS REFERENCE MANUAL FOR DETAILS ON PARAMETERS 



L 
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EIOS FILE ATTACH 



• IF THE FILE ALREADY EXISTS THEN THE USER MAKES AN "ATTACH$FILE" 
SYSTEM CALL. 



FILE$CONNECTION$TOKEN = RQ$S$ATTACH$FILE (PATH$PTR, aSTATUS); 



SEE EIOS REFERENCE MANUAL FOR DETAILS. 



V 
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EXAMPLE 



F$CONN = RQ$S$ATTACH$FILE (3(19,' :FO:SERVICE/TUNEUPS'h aSTATUS); 



A 



• I NOW HAVE A CONNECTION TO THE DIRECTORY 
"TUNEUPS" 




MEMKKiCN. FILE STKJCIUM 



| | DlRECTORttS 

/\ MIA FIUS 



Si — 80-PAHTS 



A 
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EI OS SYSTEM CALLS FOR FILES 



SYSTEM 
PROGRAMMER 



APPLICATION 
PROGRAMMER 



LOGICAL$ATTACH$DEVICE 
\ 




CREATE$FILE OR ATTACH$FILE 

OPEN 

READ 

SEEK FILE 

WRITE ACCESS 

CLOSE 
DELETE$CONNECTION OR 
DELETE$FILE 



LOGICAL$DETACH$DEVICE 



V 
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EXERCISE 



A 



• DISCUSS THE DIFFERENCES IN THE TWO SYSTEM CALLS. 



CALL RQ$A$CREATE$FILE ( 



AND 

CALL RQ$S$CREATE$FILE ( 
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CHAPTER 4 



RMX 86 EXTENDED I/O SYSTEM 

-A System Programmer's View 

• LOGICAL NAMES 

t DEVICE CONNECTIONS 
t 10 JOBS 

• DEFAULT TOKENS 



r 



Q: WHAT IS A LOGICAL NAME 



"\ 



t IF I CATALOG THE DEVICE CONNECTION TOKEN IN MY JOB'S DIRECTORY 
UNDER AN ASCII NAME, THEN THAT NAME WILL BE KNOWN TO THE EIOS 
AS THE LOGICAL NAME FOR THAT FILE CONNECTION. 



CALL RQ$CATALOG$OBJECT(0, F$TOKEN, a (4, 'AUTO'), aSTATUS) 



JOB DIRECTORY 


ASCII NAME 


OBJECT TOKEN 


' INTE$6$TASK' 


8C58 


'AUTO' 


9'!5C 


• 


• 



V 
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EIOS AND LOGICAL NAMES 



t PLACING COLONS AROUND AN ASCII STRING IDENTIFIES A 
LOGICAL NAME TO THE EIOS 



"\ 



F$CONN$l = RQ$S$ATTACH$FILE(3(15,':AUT0:TUNESCHED', aSTATUS); 



MCMKMCM. FILE HMCTUtt . . 

r OlttCTMY \ . J I BIKCIOBItS 

f\ MtA f IUS 
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THE EIOS DEVICE CONNECTION 



*\ 



ROOT JOB DIRECTORY 


ASCII NAME 


OBJECT TOKEN 


' INTE$6$TASK' 


8C58 


*MBX1' 


9'!5C 


'F8' 


846C 




SYSTEM 
V PROGRAMMER 



«/ v. 



• THE EIOS PHYSICALLY 
ATTACHES TO THE DEVICE 

• THEN CATALOGS THE 
DEVICE CONNECTION TOKEN 
UNDER A LOGICAL NAME 



FILE ACCESS 



-~LS>-0-ir> 



DELETE CONH 
DELETE FILE 



IPPLjtATION 
PROGRAMMER 
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EIOS LOGICAL ATTACHMENT 



A 



t LOGICAL ATTACH IS ACCOMPLISHED THROUGH 



CALL RQ$S$LOGICAL$ATTACH$DEVICE(LOG$NAME,DRV$NAME, FILE$DRIVER, aSTATUS), 



V 



E.G. 



CALL RQ$A$LOGICAL$ATTACH$DEVICE (a(V :F0: '), 3(2/F0'), H, 3STATUS). 
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THE 10 JOB 



• THE 10 JOB DIFFERS FROM A NORMAL JOB 

- THERE ARE THREE ENTRIES IN THE OBJECT DIRECTORY 
OF THE JOB UNDER THE NAMES "RQGLOBAL", "$", AND "R7USER" 



JOB DIRECTORY 


ASCII NAME 


OBJECT TOKEN 


•RQGLOBAL' 


8C58 


'$' 


9M5C 


'R7USER' 


9818 


• 


• 



V 
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10 JOB CREATION 



TO CREATE AN 10 JOB 



JOBITOKEN = RQ$CREATE$IO$JOB (POOL$MIN, POOLIMAX, 

EXCEPT$HANDLER, JOB$FLAGS, 
TASK$PRI0RITY, START$ADDRESS, 
DATA$SEG, STACK$PTR, 
STACK$SIZE, TASK$FLAGS, 
MSG$MBOX, aSTATUS); 



REFER TO EXTENDED 10 SYSTEM REFERENCE MANUAL. 



V. 
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I/O JOB DELETION 



t TO DELETE AN I/O JOB 

CALL RQ$EXIT$IO$JOB (USER$FAULT$CODE, 

RETURN$DATA$PTR, 

3STATUS)j 



REFER TO EXTENDED 10 SYSTEM REFERENCE MANUAL. 



V 



4-7 



\ 

"CATCH 22" 



t AN I/O JOB CAN ONLY BE CREATED BY AN I/O JOB 

§ THE SYSTEM PROGRAMMER DEFINES I/O JOBS DURING CONFIGURATION 
OF THE EXTENDED I/O SYSTEM (TO BE DISCUSSED LATER) 

• THESE I/O JOBS WILL BE CHILD JOBS OF THE EIOS 
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EIOS LOGICAL NAME SEARCH SEQUENCE 



• THE EIOS SEARCHES THREE OBJECT DIRECTORIES FOR THE 
LOGICAL NAME 

• FIRST, THE OBJECT DIRECTORY OF THE LOCAL JOB 

• SECOND, THE OBJECT DIRECTORY OF THE GLOBAL JOB 

- A JOB THAT HAS MORE "SCOPE" THAN THE LOCAL JOB 
BUT LESS "SCOPE" THAN THE ROOT JOB 

• THIRD, THE OBJECT "DIRECTORY OF THE ROOT JOB 
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THE DEFAULT PREFIX 

• THE DEFAULT PREFIX IS A DEVICE OR FILE CONNECTION TOKEN 

• IT IS CATALOGED IN THE LOCAL JOB DIRECTORY UNDER THE 
ASCII NAME "$" 

• IF A TASK FAILS TO SPECIFY A CONNECTION DURING A SYSTEM CALL 
THAT REQUIRES IT, THE EIOS USES THE DEFAULT PREFIX 
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THE DEFAULT USER 

• THE DEFAULT USER IS A USER TOKEN 

t IT IS CATALOGUED IN THE LOCAL JOB DIRECTORY UNDER THE 
ASCII NAME "R7USER" 

t THE EIOS PERFORMS ALL OF THE I/O OPERATIONS WITHIN A JOB 
ON BEHALF OF ONE USER TOKEN 



V 



r 
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EIOS EXERCISE 

1) WRITE THE CODE NECESSARY TO WRITE A STRING OF DATA TO A FILE 
ON A SBC204 SD/SS FLOPPY 

• GIVEN 

- THE FLOPPY HAS ALREADY BEEN FORMATTED 

- THE NAME OF THE DEVICE IS F0 

- THE NAME OF THE FILE IS 'COMPANY/EMPLOYEE/PERSONAL' 

- THE FILE ALREADY EXISTS 

- THE DATA TO BE WRITTEN AT THE END OF THE FILE 

- THE DATA IS 'L. JONES, 5050 MAIN DRAG, 3710217' 
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******* LAB two (EXTENDED 10 SYSTEM) ******* 



BJECTIVES: 



EXECUTE A STUDENT EXTENDED 10 APPLICATION JOB IN AN RMX86 O.S. ENVIROMENT 

INTRODUCE (EIOS) SYSTEM CALLS: 

- RQ$S$CREATE$FILE 

- RQ$S$OPEN 

- RQ$S$READ$MOVE 

- RQ$S$SEEK 

- RQ$S$WRITE$MOVE 

- RQ$S$CLOSE 

- RQ$EXIT$IO$JOB 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED START. P86 

- A SOURCE FILE NAMED EI0LAB.P86 

COMPILE (PLM86), LINK, AND LOCATE AN APPLICATION JOB, THAT WILL CALL UPON 
THE EIOS TO COMMUNICATE WITH A TERMINAL AND A FILE IN A FLOPPY 



TEP1: 



USE THE ATTACH$FILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAMEVLAB2) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAMe»/i_AB2 AS :LAB: 
* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 




<£ 



7 



(ROOT) 



$*ii*H*^- 



HII 



w 



Eg 



(APPLICATION) XX 

mmmmm 



START2 
TASK 



n 



EIOLAB 
TASK 



LAB PURPOSE 




t Use extended 10 system calls 

t Read and write to/from a terminal and a floppy 

t The student will be given the nucleus, BIOS, EIOS AND SDB 

t The student will supply the LAB2J0B and LAB2RJB 
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******* LAB TWO (EXTENDED 10 SYSTEM) ******* 
STEP2: 

MODIFY A SOURCE FILE rPARTIALLY SUPPLIED FOR YOU) NAMED :LAB:EI0LAB.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:EI0LAB.P86 

* THIS SOURCE FILE IS THE APPLICATION TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 



CREATE A BUFFER */* LENGTH=80 

CREATE FILE CONNECTION TO TERMINAL */* (9(4,' :T0:') , *N0TE1 

CREATE FILE CONNECTION TO FLOPPY */* @M3, • :FD0:LAB2DATAM , *N0TE1 

OPEN TERMINAL FILE */* fR/W) , SHARE ALL , *N0TE1 

OPEN FLOPPY FILE */* (R/W) , SHARE ALL , *N0TE1 . 

WRITE READY MESSAGE TO TERMINAL */* 

ACTUAL = 80; 

DO WHILE ACTUAL GREATER THAN ?. 

READ FROM TERMINAL */* 

WRITE TO FLOPPY */* 

READ FROM FLOPPY */* 

SEEK TO EOF MINUS ACTUAL */* 

WRITE TO TERMINAL */* 
CLOSE TERMINAL FILE */* *N0TE1 
CLOSE FLOPPY FILE */* *N0TE1 
** DELETE SELF ** CALL EXIT$IO$JOB 
*N0TE1: VALIDATE BY CHECKING STATUS = E$OK 



THE SOURCE CODE SUPPLIED DOES NOT VALIDATE CONNECTIONS 

THE STUDENT MAY WISH TO IMPLEMENT THIS FUNCTIONALITY WHEN MODIFYING 

THE SOURCE CODE 
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******* LAB TWO (EXTENDED 10 SYSTEM) ******* 
STEP3: 



* ROOT JOBS ABSOLUTELY ADDRESS THE STARTING LOCATION OF THE STUDENT'S 
JOB CODE. THE ENTRY POINT MAY VARY IF INTERNAL PROCEDURES OR 
CHARACTER CONSTANTS ARE USED. 

FOR THIS REASON IT IS ADVISABLE TO CREATE AND LINK A START TASK TO 
THE REST OF THE APPLICATION CODE TO FIX THE ENTRY POINT'S OFFSET 
INTO THE CODE 

* THIS APPLICATION JOB WILL BE A SECOND LEVEL JOB. A TASK WITHIN THIS 
JOB IS NOT REQUIRED TO MAKE A CALL TO RQ$END$INIT$TASK, THE EIOS CODE 
SUPPLIES A TASK THAT CALLS RQ$END$INIT$TASK 

* IN ORDER TO DEBUG OUR CODE BEFORE IT "CRASHES" WE MAY WISH TO 
INVOKE THE 957 MONITOR AT THE START OF OUR JOB'S EXECUTION. 

THIS CAN EASILY BE ACCOMPLISHED BY PLACING A "CAUSE$INTERRUPT(3)" 
INSTRUCTION AT THE BEGINNING OF OUR CODE (IN OUR START TASK). 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU^ NAMED : LAB: START. P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:START.PS6 

* THIS SOURCE FILE IS THE START TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 



CAUSE$INTERRUPT(3) 


CREATE THE "COMMON$ENTRY" TASK 


*/* PRI=155 


, STACKSIZE -- 


-- 512 


• ** DELETE SELF ** 
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******* LAB TWO ( EXTENDED 10 SYSTEM) ******* 
STEP4: 

COMPILE THE SOURCE FILES (START. P86 AND EI0LAB.P86) 

- PLM86 : LAB: START. P86 

- PLM86 :LAB:EI0LAB.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE FOR EACH OF 
THE SOURCE FILES: 

- A LIST' FILE NAMED ": LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED ":LAB:f SOURCE). OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 :LAB:START.OBJ,& 
:LAB:EIOLAB.OBJ,& 
/RMX5.0/DUTILS/EPIFL.LIB,& 
/RMX5.0/DUTILS/IPIFL.LIB,& 
/RMX5.0/DUTILS/RPIFL.LIB & 

TO :LAB:JOB.LNK & 
NOMAP 

LOCATE THE LINKED MODULE TO AN ABSOLUTE ADDRESS 

L0C86 :LAB:JOB.LNK .& 

TO : LAB: LAB JOB & 
SC(3) SEGSIZE(STACKfO)) & 
ORDER(CLASSES(CODE, DATA, STACK)) & 
ADDRESSES(CLASSES(C0DE(1040H))) & 
NOINITCODE & 
OC(PURGE) 

AND FINALLY ADD THE LOCATED MODULE TO THE OTHER PRECONFIGURED 
PARTS OF OUR SYSTEM 

LIB86 

DELETE :LAB:RMX86(STARTM0D) 

ADD : LAB: LAB JOB to :LAB:RMX86 

EXIT 

* IN THE LINKING PROCESS OBSERVE THAT WE LINKED THE START MODULE FIRST 

* !!! NO WARNINGS OR ERRORS DURING LINK 

* !!! SOME WARNINGS ARE OK DURING LOCATE (SEE INSTRUCTOR) 

* :LAB:RMX86 IS A "GIVEN" FILE THAT CONTAINS: 

- A PRECONFIGURED NUCLEUS 

- A PRECONFIGURED BIOS 

- A PRECONFIGURED EIOS 

- A PRECONFIGURED SDB 

- A PRECONFIGURED ROOT JOB 

* THE STUDENT MAY "OPTIONALLY" USE A "GIVEN" SUBMIT FILE THAT WILL 
COMPILE , LINK , LOCATE AND ADD THE FINAL MODULE TO THE SYSTEM 



- SUBMIT :LAB:JOB.CSD 4 _ 16 



******* LAB TWO (EXTENDED 10 SYSTEM) ******* 
STEP5: 

* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /"TEAM NAME"/LAB2/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 
( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

* GOOD LUCK...! 
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CHAPTER 5 
WRITING DEVICE DRIVERS 

-Generalities 

t INDEPENDENT 10 

t DRIVER COMPONENTS, 

t THE DUIB 

• THE I/O REQUEST 

t DRIVER FUNCTIONS 



r 



FILE DRIVERS 







PHYSICAL 

> 






NAMED 






STREAM 

- r 



DEVICE INDEPENDENCE 
DEVICE DRIVERS 



USART 



WINCHESTER 



FLOPPY 



STREAM 



HARDWARE 



C2* 

8 




MEMORY 
POOL 



"\ 




V 
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DEVICE INDEPENDENT I/O 

• APPLICATION TASKS COMMUNICATE WITH FILE DRIVERS 

- THIS ALLOWS TASKS TO MANIPULATE ALL FILES IN THE SAME MANNER 

f FILE DRIVERS COMMUNICATE WITH DEVICE DRIVERS 

- THEY PROVIDE THE INTERFACE BETWEEN SOFTWARE AND HARDWARE 

• THIS STANDARD INTERFACE HAS ADVANTAGES 

- THE HARDWARE CAN BE CHANGED WITHOUT EXTENSIVE MODIFICATION 
TO THE SOFTWARE 

- THE I/O SYSTEM CAN SUPPORT A GREATER RANGE OF DEVICES. 
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DEVICE DRIVER COMPONENTS 



"N 



UNIT 



V 




UNIT 1 



AW 

I ~ 5=1 



*— ' L * 



* A 



UIT 




DIT 



CONTROLLER 



DEVICE 
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THE DUIB STRUCTURE 
(DEVICE UNIT INFORMATION BLOCK) 



NAME (14) -=^ 


FILESDRIVERS 




FUN ITS 






FLAGS 


DEV$GRAN 




LOW$DEV$SIZE 




HIGH$DEV$SIZE 




DEVICE 






UNIT 


DEV$UNIT 




INIT$IO 




FINISH$IO 




QUEUESIO 




CANCEL 10 




DEVICES I NFO$PTR 


UNIT$INFO$PTR 


UPDATE$TIMEOUT 




NUM$BUFFERS 




PRIORITY 







•REFER TO "GUIDE TO WRITING DEVICE DRIVERS" REFERENCE MANUAL. 
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THE DUIB 

• THE DEVICE UNIT INFORMATION BLOCK IS A TABLE OF VALUES DESCRIBING 
THE COMPONENTS OF A DEVICE DRIVER. 

• IT IS CREATED BY THE SYSTEM PROGRAMMER DURING CONFIGURATION OF 
THE BASIC I/O. 

t THE DUIB BINDS THE FILE DRIVER TO THE DEVICE DRIVER BY DESCRIBING 
POINTERS TO THE DEVICE DRIVER PROCEDURES. 



FILE 
DRIVER 



DUIB 



& 




j<PROC 



PR0C 



PROC 



V. 
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THE DEVICE DRIVER "PROCEDURES" 

• THE DEVICE DRIVER PROCEDURES ARE CALLED BY THE FILE DRIVER 

• THESE PROCEDURES 

- CONTAIN THE CODE NECESSARY TO COMMUNICATE WITH THE HARDWARE 

- MAINTAIN THE QUEUE 

• THE ADDRESSES OF THESE PROCEDURES ARE IMBEDDED IN THE DEVICE 
UNIT INFORMATION BLOCK (DUIB) 



/ / 


v *. 




4 

FILE t-i 
drivefN^J 


DUIB 


*t 






r 
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THE I/O REQUEST 

• WHEN THE APPLICATION TASK CALLS THE BASIC I/O SYSTEM 
AN IORS IS GENERATED (I/O REQUEST SEGMENT) 



APPLICATION TASK 
CALL RQ$A$READ ( . 




A 




BASIC I/O 



. ); 





READ 




I 


^¥- 



R 




S 
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THE REQUEST QUEUE 

• THE FILE DRIVER SENDS IORS TO THE DEVICE DRIVER (QUEUE 10 PROC) 

• IF THE DEVICE DRIVER IS "BUSY", THE IORS IS PLACED AT THE 
END OF THE QUEUE 











I 




1 

1 







R 


\ 


1 






S 


\ 


1 












ait 

UJ 

>l 
°1 




I 


R 
S 


J 


1 

UJ 

—ll 


I 







' 






1 


R 


^—^T-N 


1 / 


S 


r 


1 


% 


: l 


* > 


1 




QUEUE 










REGION 
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THE REGION 

• PROTECTION OF THE QUEUE IS ACCOMPLISHED THROUGH A REGION 

- THE TASK CALLS THE iRMX O.S. 
TO GAIN ACCESS TO THE QUEUE 











IORS 


*x 




- IHt 1 ASK MANIPULATES OBJECTS 


IN THE QUEUE 






\ 


/ 


N. 


) 




IORS 


y 


- THE TASK THEN CALLS THE iRMX 


c 


IORS 




^\ 




O.S. TO RELEASE ACCESS TO 
THE QUEUE 


/— 




Ev 






\ 


^ 


1 


CD 








\ 


QUEUE / 
REGION 







5-10 



r 



v 



"N 



DEVICE DRIVER FUNCTIONS 

• A DEVICE DRIVER NAY SUPPORT UP TO EIGHT FUNCTIONS 

- READ 

- WRITE 

- SEEK 

- SPECIAL 

- ATTACH 

- DETACH 

- OPEN 

- CLOSE 



SPECIAL FUNCTION = SCF 

(STOP & CATCH FIRE!) 




5-11 



r 



"S 



QUEUE IMPLEMENTATION 
• THE IORS STRUCTURE CONTAINS FORWARD AND BACKWARD POINTER FIELDS 



/ i. 



F 



HEAPJPQINTFR 



REAR$PO INTER 



READ 



FORWARD 




SEEK. 



FORWARD 



BACKWARD BACKWARD 




BEAU. 



FORWARD 



BA CK W ARD 



UOSF 



FORWARD 



BACKWARD 



V 
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THE IORS STRUCTURE 
(INPUT OUTPUT REQUEST SEGMENT) 



STATUS 




UNIT$STATUS 




ACTUAL 




ACTUALIF I LI- 




DEVICE 




UNIT 






FUNCT 


SUBSFUNCT 




LOW$DEV$LOC 




HIGH$DEV$LOC 




BUF$PTR 


COUNT 




COUNT$FILL 




AUX$PTR 


LINKSFOR 


LINKSBACK 


RESPSMBOX 




DONE 






FILL 


CANCEL ID 





•REFER TO "GUIDE TO WRITING DEVICE DRIVERS" REFERENCE MANUAL. 



>v 
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QUEUE PROTECTION 

• THE QUEUE IS A SHARED RESOURCE OF OTHER DEVICE DRIVER 
COMPONENTS 

• THE QUEUE CAN ONLY BE ACCESSED BY ONE OF THE DEVICE DRIVER 
COMPONENTS AT A TIME 



• THAT COMPONENT MUST HAVE A KEY TO USE THE QUEUE #$&?& 
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SOME FACTS ABOUT REGIONS 

• ONCE A TASK GAINS ACCESS TO A REGION 

- THE PRIORITY OF THE TASK MAY BE TEMPORARILY RAISED 

- THIS OCCURS AUTOMATICALLY IF THE REGION IS PRIORITY BASED, 
AND THERE IS A TASK OF HIGHER PRIORITY WAITING TO USE 
THE REGION 

- THE TASK CANNOT BE SUSPENDED OR DELETED UNTIL IT SURRENDERS 
ACCESS TO THE REGION 



V 



r 



v. 
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SYSTEM CALLS FOR REGIONS 



§ REGION = RQ$CREATE$REGION (FLAGS, 3STATUS); 

• CALL RQ$SEND$CONTROL OSTATUS); 

CALL RQ$RECEIVE$CONTROL <REGION,aSTATUS); 

• CALL RQ$ACCEPT$CONTROL (REGION,aSTATUS); 

• CALL RQ$DELETE$REGION (REGION.3STATUS); 

REFER TO SYSTEM PROGRAMMER'S REFERENCE MANUAL 
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THE (DIT) AND (UIT) 
t ALL DUIB'S ARE FIXED LENGTH 

• SOME DEVICE DRIVERS NEED MORE INFORMATION 

• THE SYSTEM PROGRAMMER MAY "OPTIONALLY" PROVIDE TWO EXTRA 
TABLES OF UNBOUND LENGTH 



DEVICE UNIT INFO BLOCK 



DUIB 



DIT 



UIT 



DEVICE INFO TABLE 



DIT 



WlMAA 



UNIT INFO TABLE 



UIT 



vwvvty 



V 



• THE DUIB CONTAINS POINTERS TO THESE TABLES 
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EXERCISE 

• WHY ARE THE ADDRESS FIELDS IN THE DUIB, FOR THE DRIVER 
PROCEDURES, ONLY WORD FIELDS AND NOT POINTER FIELDS? 



• NAME SOME GENERAL DEVICE DRIVER COMPONENTS. 



• NAME ONE ADVANTAGE OF A REGION vs. SEMAPHORE FOR RESOURCE 
PROTECTION. 
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DEVICE DRIVER TYPES 

t THERE ARE THREE. TYPES OF DEVICE DRIVERS IN THE iRMX ENVIRONMENT 

- COMMON DEVICE DRIVER 

- RANDOM ACCESS DEVICE DRIVER 

- CUSTOM DEVICE DRIVER 
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CHAPTER 6 



THE CUSTOM DEVICE DRIVER 



^ 
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THE DUIB STRUCTURE 
(DEVICE UNIT INFORMATION BLOCK) 



NAME CUD <=* 


FILE SDR I VERS 




FUN ITS 




FLAGS 


DEV$GRAN 




LOW$DEV$SIZE 




HIGH$DEV$SIZE 




DEVICE 






UNIT 


DEV$UNIT 




INITSIO 




FINISH$IO 




QUEUE$IO 




CANCEL 10 




DEVICE$I'NF0$PTR 


UNIT$INF0$PTR 


UPDATE $T I MEOUT 




NUMSBUFFERS 




PRIORITY 







•REFER TO "GUIDE TO WRITING DEVICE DRIVERS" REFERENCE MANUAL. 
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THE CUSTOM DEVICE DRIVER 

• THE CUSTOM DEVICE DRIVER IS NEEDED IF 

- TWO OR MORE INTERRUPT LEVELS PER DEVICE ARE REQUIRED 

- PRIORITY ORDERED REQUEST QUEUE IS REQUIRED 

- THE DEVICE DOES NOT FIT INTO THE COMMON RANDOM ACCESS 
DEVICE CATEGORY (TO BE DISCUSSED LATER) 




V. 
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CUSTOM DEVICE DRIVER COMPONENTS 



• TO WRITE A CUSTOM DEVICE DRIVER YOU MUST PROVIDE 



- AN INITIALIZE I/O PROCEDURE 



A FINISH I/O PROCEDURE 



- A QUEUE I/O PROCEDURE 



- A CANCEL I/O PROCEDURE 



- A DEVICE INTERRUPT TASK AND HANDLER 



INIT 

10 

PROG 



FINISH 

10 
PROC 



QUEUE 

10 

PROC 



CANCEL 

10 

PROC 



RQSIGNAL 



' pNDieafl 



mi 



"N 



r 
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THE DEVICE INTERRUPT HANDLER 



• EXAMPLE INTERRUPT HANDLER 

- WHEN THE DEVICE CONTROLLER FINISHES A REQUEST (READ, SEEK,. 
IT GENERATES AN INTERRUPT. 

- THE INTERRUPT HANDLER THEN SIGNALS THE INTERRUPT TASK 

HARDWARE 

UNIT UNIT 1 



.WRITE) 



RQ$SIGNAL 







DEVICE 
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INTERRUPT TASK 



• THERE ARE 3 PARTS TO AN INTERRUPT TASK 



INTERRUPT 



HANDLER 



^ 



RQSIGNAL 



1) 



TASK 
IDENTIFICATION 

TO 
THE RMX O.S. 



2) 



■waitingtoT 

THE 
EVENT 



3) 



WORK TO BE 
DONE BY 
THE TASK - 



/ 
/ 



V 
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THIS IS DONE ONLY ONCE 



EXAMPLE DEVICE INTERRUPT TASK 



IDENTIFY HANDLER & TASK TO THE RMX 86 O.S. 



DO FOREVER 



WAIT FOR HANDLER TO SIGNAL 



GAIN ACCESS TO REGION 



REMOVE IORS FROM QUEUE 



SEND IORS TO A RESPONSE MAILBOX (IMBEDDED IN IORS) 



SEND COMMANDS TO DEVICE TO START NEXT REQUEST (IF ANY!) 



SURRENDER ACCESS TO REGION 




3: HOW DOES THE FIRST REQUEST GET STARTED? 
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THE QUEUE I/O PROCEDURE 



• THE BASIC I/O SYSTEM CALLS THE QUEUE I/O PROCEDURE 
IN THE FOLLOWING MANNER 

CALL QUEUE$IO(IORS$T,DUIB$P,D$DATA$T); 

WHERE: 

- IORS$T IS THE TOKEN FOR THE I/O REQUEST SEGMENT 

- DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION BLOCK 
OF THE DEVICE 

- D$DATA$T IS A TOKEN FOR A DATA STORAGE AREA (CREATED BY THE 
INIT I/O PROCEDURE), CONTAINS (HEAD OF QUEUE, REGION TOKEN, 
. . .INTERRUPT TASK TOKEN, . . .ETC) 



r 
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EXAMPLE - QUEUE I/O PROCEDURE 



V 




THIS IS WHERE 
THE FIRST REQUEST 
GETS STARTED 



dedQ 



ED ED 
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THE INIT I/O PROCEDURE 

• THE BASIC I/O SYSTEM CALLS THE INIT I/O PROCEDURE IN THE 
FOLLOWING MANNER: 

CALL INIT$IO(DUIB$P,D$DATA$P,STATUS$P); 

WHERE: 

- DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION BLOCK OF THE DEVICE 

- D$DATA$P IS A POINTER TO A WORD WHERE THE INIT I/O PROCEDURE 
PLACES THE TOKEN FOR A DATA STORAGE AREA 

- STATUSSP IS A POINTER TO A WORD WHERE THE INIT $1/0 PROCEDURE 
PLACES A STATUS OF THE INITIALIZE OPERATION (SUCCESSFUL OR NOT 
SUCCESSFUL) 
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EXAMPLE INIT I/O PROCEDURE 



V 



CREATE THE DATA STORAGE AREA 



CREATE THE REGION FOR ACCESS TO QUEUE 



CREATE THE INTERRUPT TASK 



INITIALIZE THE DEVICE 



INITIALIZE THE DATA STORAGE AREA 



RETURN 
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THE FINISH I/O PROCEDURE 



I THE BASIC I/O CALLS THE FINISH I/O PROCEDURE IN 
THE FOLLOWING MANNER: 

CALL FINISH$IO(DUIB$P,D$DATA$T)j 



WHERE: 

- DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION 
BLOCK OF THE DEVICE 

- D$DATA$T IS A TOKEN FOR THE DATA STORAGE AREA 
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EXAMPLE FINISH I/O PROCEDURE 



V 



\ 




\ 


s 


SENDS COMMANDS (IF NEEDED) 
TO DE-PROGRAM DEVICE 


RESET/DELETE INTERRUPT TASK 


DELETE REGION 


DELETE DATA STORAGE AREA 


RETURN 
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THE CANCEL I/O PROCEDURE 



t THE BASIC I/O SYSTEM CALLS THE CANCEL I/O PROCEDURE IN 
THE FOLLOWING MANNER: 

CALL CANCEL$IO(CANCEL$ID,DUIB$P,D$DATA$T); 
WHERE: 

- CANCEL$ID IS A WORD CONTAINING THE ID # OF THE REQUESTS, 
WAITING IN THE QUEUE, TO BE CANCELLED. 

- DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION BLOCK 
OF THE DEVICE 

- D$DATA$T IS A TOKEN FOR THE DATA STORAGE AREA 



"\ 



V. 
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EXAMPLE CANCEL I/O PROCEDURE 



GAIN ACCESS TO THE REGION 



DO WHILE IORS NEEDS TO BE CANCELLED 



\ DEVICE CURRENTLY PROJ 




SURRENDER ACCESS TO THE REGION 



RETURN 
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RELATIONSHIP BETWEEN CALLS 



TASK—tMO SYSTEM 
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EXERCISE 



t WRITE THE QUEUE$I/0 PROCEDURE HEADING AND DECLARATIONS 
IN PL/M 86. 



• WHAT IS A DATA STORAGE AREA? 



• WHEN IS THE INIT$I/0 PROCEDURE CALLED? 



t WHEN IS CANCEL$I/0 CALLED? 



• HOW DOES THE INTERRUPT HANDLER KNOW WHERE THE DATA STORAGE 
AREA IS LOCATED? 



A 
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CHAPTER 7 
DEVICE DRIVERS 

(Random Access and Common Device Drivers) 

t COMPONENTS 

§ THE INTERRUPT PROCEDURE 

t THE START PROCEDURE 

• DEVICE INFORMATION TABLE 



V 
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THE COMMON DEVICE DRIVER 



"\ 



I 



• SIMPLE DEVICES 

E.G. LINE PRINTERS, US ART 

• FIFO MECHANISM FOR QUEUING REQUESTS IS SUFFICIENT 

• ONLY ONE INTERRUPT LEVEL IS NEEDED TO SERVICE A DEVICE 

• DATA READ OR WRITTEN BY THESE DEVICES DOES NOT NEED TO BE 
BROKEN UP INTO BLOCKS. 





J 
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THE RANDOM ACCESS DEVICE DRIVER 



• COMPLEX DEVICES 

E.G. HARD DISK, BUBBLE MEMORY, FLOPPY 

• FIFO MECHANISM FOR QUEUING REQUESTS IS SUFFICIENT 

• ONLY ONE INTERRUPT LEVEL IS NEEDED TO SERVICE A DEVICE 

t I/O REQUESTS MUST BE BROKEN UP INTO BLOCKS OF SPECIFIC LENGTH 

• THE DEVICE SUPPORTS RANDOM ACCESS SEEK OPERATIONS 




~> 



3 



V 
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RANDOM/COMMON DEVICE DRIVER COMPONENTS 




I 
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I/O SYSTEM SUPPLIED PROCS 

• THE BASIC 10 SYSTEM PROVIDES PROCEDURES THAT COMPRISE THE 
BULK OF WRITING A RANDOM ACCESS OR COMMON DEVICE DRIVER. 



- PROCEDURE NAMES - 

• "RAD$INIT$IO" OR "INITSIO" 

• "RAD$FINISH$IO OR "FINISH$IO" 

• "RAD$QUEUE$IO" OR "QUEUE$IO" 

• "RAD$CANCEL$IO" OR "CANCEL$IO" 
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THE DEVICE$INTERRUPT PROCEDURE 

• THE INTERRUPT TASK, SUPPLIED BY THE 10 SYSTEM, CALLS THE INTERRUPT 
PROCEDURE IN THE FOLLOWING MANNER: 

CALL DEVICE$INTERRUPT(IORS$P, DUIB$P, DDATA$P); 

WHERE: 

-IORS$P IS A POINTER TO THE I/O REQUEST SEGMENT 

-DUIB$P IS A POINTER' TO THE DEVICE UNIT INFORMATION BLOCK 

-DDATA$P IS A POINTER TO A USER REQUESTED RAM SEGMENT (SCRATCH PAD AREA) 
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DEVICE DEPENDENT PROCS 

t TO WRITE A RANDOM ACCESS OR COMMON DEVICE DRIVER 
YOU MUST PROVIDE: 



SYSTEM SUPPLIED DEVICE DEPENDENT 
PROCS PROCS 



INIT 10 
PROC 



FINISH 10 
PROC 



QUEUE 10 
PROC 



CANCEL 10 
PROC 



c 



IJNTH8B 



mmm 



Uas 



~if 



DEVICE INIT 



DEVICE 



FINISH V 




7\ 



DEVICE START 



DEVICE STOP 



P 



DEVICE INTERRUPT 



3 



• A DEVICESINIT PROCEDURE 



• A DEVICE$FINISH PROCEDURE 



• A DEVICE$START PROCEDURE 



• A DEVICE$STOP PROCEDURE 



t A DEVICE$INTERRUPT PROCEDURE 
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EXAMPLE DEVICE$INTERRUPT PROCEDURE 
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THE DEVICE$START PROCEDURE 

• THE INTERRUPT TASK AND THE QUEUESIO PROCEDURE , SUPPLIED BY THE 

10 SYSTEM, CALLS THE DEVICE$START PROCEDURE IN THE FOLLOWING MANNER: 

CALL DEVICE$START(IORS$P, DUIB$P, DDATA$P); 
WHERE: 

- IORS$P IS A POINTER TO THE I/O REQUEST SEGMENT 

- DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION BLOCK 
-DDATA$P IS A POINTER TO A USER REQUESTED RAM SEGMENT 



7-8 
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THE DEVICESINIT PROCEDURE 

• THE INIT$IO PROCEDURE, SUPPLIED BY THE 10 SYSTEM, 

CALLS THE DEVICESINIT PROCEDURE IN THE F0LL0WIN6 MANNER: 

CALL DEVICE$INIT(DUIB$P,DDATA$P,STATUS$P); 
WHERE: 

-DUIB$P IS A POINTER" TO THE DEVICE UNIT INFORMATION BLOCK 
-DDATA$P IS A POINTER TO A USER REQUESTED RAM SEGMENT 

-STATUS$P IS A POINTER TO A WORD WHERE THE RESULT OF THE CALL 
WILL BE STORED BY THE USER 



"\ 
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EXAMPLE DEVICES I NIT PROCEDURE 



*\ 



\ 


X 


--^DEVICE POWER ISON^^. — ■ — 


STATUS = ERROR 


INITIALIZE DEVICE 


STATUS = OK 


RETURN 



V 
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THE DEVICE$FINISH PROCEDURE 

• THE FINISH $10 PROCEDURE, SUPPLIED BY THE 10 SYSTEM, CALLS 
THE DEVICE$FINISH PROCEDURE IN THE FOLLOWING MANNER: 

CALL DEVICE$FINISH(DUIB$P, DDATAIP); 



"\ 



WHERE: 

-DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION BLOCK 

-DDATA$P IS A POINTER TO A USER REQUESTED RAM SEGMENT 
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EXAMPLE DEVICEIFINISH PROCEDURE 



"N 



FINAL 
PROCESS!!* 



S & CF INSTRUCTION 



RETURN 
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THE DEVICE$STOP PROCEDURE 

• THE CANCEL$IO PROCEDURE, SUPPLIED BY THE 10 SYSTEM, CALLS 
THE DEVICE$STOP PROCEDURE IN THE FOLLOWING MANNER: 

CALL DEVICE$STOP(IORS$P, DUIB$P, DDATA$P); 



WHERE: 

- IORS$P IS A POINTER TO THE I/O REQUEST SEGMENT 

- DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION BLOCK 

- DDATA$P IS A POINTER TO A USER REQUESTED RAM SEGMENT 
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EXAMPLE DEVICEISTOP PROCEDURE 







\ 


STOP CURRENT I/O 


RETURN 
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THE DEFAULT PROCEDURES 

• THE I/O SYSTEM PROVIDES THREE NULL PROCEDURES THAT 
THE USER MAY USE. 



THEY ARE: 



- "DEFAULTS I NIT" 

- "DEFAULT$FINISH" 

- "DEFAULT$STOP" 



V. 
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DIT'S 
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• COMMON AND RANDOM ACCESS DEVICE INFORMATION TABLES ARE CREATED 

BY THE SYSTEM'S PROGRAMMER DURING CONFIGURATION OF THE BASIC I/O SYSTEM, 

THE DIT BINDS THE 10 SYSTEM SUPPLIED PROCEDURE TO THE DEVICE " 
DEPENDENT PROCEDURES BY DESCRIBING POINTERS TO THEM. 



DIT 
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THE DIT STRUCTURE 
(DEVICE INFORMATION TABLE) 



LEVEL 



PRIORITY 



STACK$SIZE 



DATA$SIZE 



NUM$UNITS 



DEVICE$INIT 



DEVICEIFINISH 



DEVICE$START 



DEVICEISTOP 



DEVICES INTERRUPT 



USER MAY 

APPEND MORE FIELDS 



• REFER TO "GUIDE TO WRITING DEVICE DRIVERS" REFERENCE MANUAL. 
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UIT'S 



• UNIT INFORMATION TABLES ARE CREATED BY THE SYSTEM PROGRAMMER 
DURING CONFIGURATION OF THE BASIC 10 SYSTEM. 



TRACK$SIZE 



MAX$RETRY 



RESERVED 



•USER MAY APPEND 
MORE FIELDS 



V. 
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TABLES AND CALLS 



TASK- 



•IO$SYSTEM 



PUiB 



INIT 10 



CANCEL 10 



FINISH 10 




NIT$IO- 



QUEUE$IO- 



*DEVICE$INIT- 

/ 

DEVI CESST ART 



/ 1NTERRUPJ$HANDLER 






DEVICE 



CANCELS 10 

s 



/ / 



/ / 



ERRUPT$TASK 
■/»-DEVICE$STOP 



FINISH$IO' ; / » DEVICE$FINISH 
// / /> 




/ '/ 



/ / s 
s 



• 


DEVICE INIT 


DEVICE START 


DEVICE INTERRUPT 


DEVICE STOP 


DEVICE FINISH 





/ 



V 
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******* lab THREE r COMMON DEVICE DRIVER) ******* 



DBJECTIVES: 



EXECUTE A GIVEN APPLICATION JOB, THAT WILL CALL UPON THE BIOS 
TO COMMUNICATE WITH A LIGHT BOX 

THE STUDENT WILL WRITE A COMMON DEVICE DRIVER TO SUPPORT THE 
LIGHT BOX HARDWARE 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED DEVDRV.P86 

- A SOURCE FILE NAMED LBOXDUIB.SRC 

- A SOURCE FILE NAMED LBOXDUIT.SRC 



STEP1: 



USE THE ATTACH$FILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAMEVLAB3) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAMEVLAB3 AS :LAB: 

* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 




gj 1 1 i 1 1 1 1 1 1 1 1 M i i i I i g^X 



HI 



^r.. ' . 1 . ' , 1 '. .'J i i.u.':. '.' i ' i Vi' 



■i 



{APPLI* 
CATION} 




Write a common device driver for the light box 

• The student will be given the nucleus, SDB, application and root 

• The student will supply init, start and interrupt procedures for 
the driver 

• The student will build a BIOS with preconfigured ITABLE.A86 and 
IDEVCF.A86 
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******* LAB THREE (COMMON DEVICE DRIVER) ******* 

STEP2: 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB:LBOXDUIB.SRC 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:LBOXDUIB.SRC 

* THIS SOURCE FILE CONTAIN PARTIALLY WRITTEN SOURCE CODE TO THE DUIB TABLES 
NEEDED TO SUPPORT THE LIGHT BOX DRIVER 



STEP3: 



MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB:LBOXDUIT.SRC 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:LBOXDUIT.SRC 

* THIS SOURCE FILE CONTAIN PARTIALLY WRITTEN SOURCE CODE TO THE DIT TABLES 
NEEDED TO SUPPORT THE LIGHT BOX DRIVER 



STEP4: 



MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB:DEVDRV.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:DEVDRV.P86 

* THIS SOURCE FILE CONTAIN PARTIALLY WRITTEN SOURCE CODE TO THE FOLLOWING 
PROCEDURES: 

- A LIGHT BOX DEVICE INTERRUPT PROCEDURE 

- A LIGHT BOX DEVICE START PROCEDURE 

- A LIGHT BOX DEVICE INIT PROCEDURE 
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******* lab THREE (COMMON DEVICE DRIVER) ******* 

>TEP5: 

COMPILE THE SOURCE FILE DEVDRV.P86 
- PLM86 :LAB:DEVDRV.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE FOR THE 

SOURCE FILE: 

- A LIST FILE NAMED ":LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED ":LAB: (SOURCE) .OBJ" 

5TEP6: 

* WE MUST NOW ADD THE OBJECT CODE THAT. WE HAVE GENERATED TO 
THE BIOS SYSTEM 

* THEN WE MUST BUILD A LOADABLE SYSTEM THAT INCLUDES: 

- THE NUCLEUS 

- THE BIOS ( YOU SUPPLY THE LIGHT BOX DRIVER ) 

- THE SDB 

- THE APPLICATION JOB (SUPPLIED) THAT CALLS YOUR DRIVER 

- THE ROOT JOB 

* THIS IS ACCOMPLISHED THROUGH SEVERAL LINKS, LOCATES AND FINALLY 
USING THE LIB86 UTILITY 

* A SUBMIT FILE IS SUPPLIED 

- SUBMIT :LAB:ICU.CSD 

TEP7: 

* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 
REMEMBER THE MAP FILE IS :LAB:IOS.MP2 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREAtED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /"TEAM NAME"/LAB2/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 
( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
-BOOT THE NEW SYSTEM 
.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
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CHAPTER 8 
BASIC I/O SYSTEM 

Configuration 

• TABLES 

• ICU86 



STEPS IN BUILDING THE BASIC I/O SYSTEM 



1) TWO CONFIGURATION FILES ARE NEEDED CITABLE. A86 AND IDEVCF.A86) 

2) ASSEMBLE EACH CONFIGURATION FILE 

3) LINK AND LOCATE THE BIOS 





ITABLE 




IDEVCF 






* 








ASSEMBLER 










IOS.LIB 




— * + 








LINK 






4 




LOCATE MAP 


LOCATE 








1 




I0S.MP2 




I OS 





) 



ALTER I . . . # A86 



• ITABLE CONTAINS SYSTEM CALLS 
AND FILE DRIVERS AND TABLES 

• IDEVCF CONTAINS DEVICE DRIVERS 
INTO TABLES (DUIBS, DITS, UITS) 

• REFER TO CONFIGURATION .MANUAL 
THROUGH THE REST OF THIS CHAPTER 
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ITABLE. A86 



"\ 




PARAMETER INTERFACE 



ZRQ_CREATE_USER 

ZRQJNSPECTJJSER 

ZRQ_DELETE_USER 

XRQ_SET_DEFAULT_USER 

ZRQ_SET_DEFAULT_USER 

ZRQ_SET_DEFAULT_PREFIX 

ZRQ_GET_DEFAULT_PREFIX 

ZRQ_A_PHYS I CAL_ATTACH_DEVI CEV. 
ZRQ_A_PHYSICAL_DETACH_DEVI CE^>~ CONFIGURAT I 0N INTERFACE 

ZRQ_POWER_DOWN *-- _ 

ZRQ_POWER_UP ,— . ^ « POWER-FAIL INTERFACE 

ZRQ_SET_TIME* 
ZRQ_GET_TIME. 

ZNUM_FILE_DRIVERS(i»J 

ZATTACH_DEVICE_TASK_PRI0(129)^^» DEFINE FILE-DRIVER GLOBAL PARAM 

ZTIMER_TASK_PRI0(129L 

;DUMMY_TIMER 

;NO_CREATE_FALSE 

;NO_TRUNCATE 

;NO_ALLOCATE. 



•TIME INTERFACE 




OTHER FEATURES 



•REQUEST & IOS FILE-DRIVER CONFIGURATION TABLES 



END 
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IDEVCF.A86 



EXTRN INITIO: NEAR' 

EXTRN FINISHIO: NEAR 

EXTRN QUEUEIO: NEAR 

EXTRN 12041 NIT: NEAR 

EXTRN 1204START: NEAR 

EXTRN 12041 NTERRUPT: NEAR. 



EXTERNAL PROCEDURES 
DEFINITIONS 



V 
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IDEVCF.A86 (CONTINUED-) 
; SPC 204 CONTROLLER UNIT 0' 



DEFINE_DUIB \ 


& 'F0', 


NAME (14) \ 


& 00BH, 


FILEDRIVERS \ 


8 0FFH, 


FUNCTS \ 


& 00H, . 


FLAGS \ 


& 128, 


DEV GRANULARITY \ 


& 0E900H,03H, , 


DEV SIZE = 256256 \ 


& 0, 


DEVICE # \ 


& 0, 


UNIT # ^ 


& 0, 


DEVICE-UNIT # 


& INITIO, 


DRIVER PROCS i 


& FINISHIO j , 




& QUEUEIO, 




& CANCELIO, , 




& DINFO_204, , 


DIT / 


& VINF0JHUGAR1 


r, ; UIT / 


& 100, 


UPDATE TIMEOUT / 


& 6, 


NUMBER OF BUFFERS / 


S 129 


INITIAL TASK PRIORITY/ 


*> 





DUIB 
DEFINITIONS 
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IDEVCF.A86 (CONTINUED) 



"\ 



DINFO_204 

& 58H, 

& 81H, 

& 209, 

& 127, 

& H, 

& I204INIT, 

& DEFAULTFINISH, 

& I204START, ; 

& DEFAULTSTOP, ; 

S I204INTERRUPT ; 

*> 



RADEV_DEV_INFO< 
LEVEL 
PRIORITY 
STACK SIZE 
DATA SIZE 
NUM UNITS 
DRIVER PROCS 




DEVICE INFO TABLE 



DW 



0A0H 



; BASE ADDRESS • 



EXTRA INFO MAY BE 
APPENDED HERE 



V. 
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IDEVCF.A86 (CONTINUED) 



UINFO_SHUGART 


RADDEV_UNIT. 


INFO 


< 


& 26 


* 128, , 


TRACK SIZE 






& 9, 


< 


MAX RETRY 






& 










«> 










j 


204 SPECIFIC 






DW 


i\ 


RESERVED 






DB 


035H,0DH , 


FIXED I NIT VALUES 




DB 


8 


STEP RATE 






DB 


8 


SETTLE 






DB 


39H 


ENT LOAD 







UNIT INFO TABLE 



EXTRA INFO IS 
APPENDED HERE 
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THE SUBMIT FILE (86/330 STYLE) 
IOS.CSD 

; ASSEMBLE THE TABLES 

ASM86 /RMX/DBI0S/ITABLEA86 WORKFI LES(: WORK:, .-WORK: ) 
ASM86 /RMX/DBI0S/IDEVCF.A86 WORKFI LES(: WORK:,: WORK : ) 
;LINK THE BIOS 
LINK 86 /RMX/DBIOS/IOS.LIB(ISTART),& 

/RMX/DBIOS/ITABLE.OBJ ,& 

/RMX/DBIOS/IDEVCF.OBJ ,& 

/RMX/DBIOS/ITDR.LIB ,g 

•/RMX/DHI/HI . LIB(HCONTC) ,8 

/RMX/DBI0S/I00PT1.LIB ,& 

/RMX/DBIOS/IOS.LIB ,& 

/RMX/DNUCLUS/RPIFC.LIB ,& 

TO /RMX/DBIOS/IOS.LNK & 

NO PUBLICS EXCEPT(RQAIOSINITTASK,RQAIOSINITERROR) 
j LOCATE THE BIOS 

LOCATE /RMXDBIOS/IOS.LNK & 
TO /RMX/DBIOS/IOS.LNK & 

SEGSIZE (STACK (0) ) & 

ORDER (CLASSES <CODE,DATA)) & 

ADDRESSES (CLASSES (C0DE(%1))) & .ADDRESS OF BIOS IS PASSED 

NOINITCODE AS A PARAMETER 



>i 



► FOUND 'IN MISCELLANEOUS DISKETTE 



COMPACT! 
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LOCATE ADDRESSES 

• THE LOCATE PROGRAM GENERATES A MAP FILE CALLED 

/RMX/DBI0S/I0S.M12 

• EXAMINING THE MAP WE OBTAIN THE ENDING ADDRESS OF THE BIOS 
MEMORY MAP OF MODULE ISTART 



A 



SEGMENT MAP 










START 


START 


LENGTH 


ALIGN 


NAME 


CLASS 


00200H 


00216H 


0017H 


A 


(ABSOLUTE) 




07190H 


14E85H 


DCF6H 


W 


CODE 


CODE 


14E86H 


14E93E 


000EF 


W 


PARAM SEG 


CODE 


1UE94H 


14E97H 


0004H 


W 


CONFIG SEG 


CODE 


14E98H 


14B9BH 


000MH 


W 


POWER SEG 


CODE 


14E9CH 


14E9FH 


0004H 


W 


TIME SEG 


CODE 


14EA0H 


14EBBH 


001CH 


W 


FILE_DRIVER_IN 
-FO_SEG 


CODE 


14EBCH 


14F7BH 


00C0H 


W 


REQ TABLE 


CODE 


14F7CH 


1504BH 


00D0H 


W 


I OS TABLE 


CODE 


1504CH 


1509DH 


0052H 


W 


DATA 


DATA 


150A0H 


150AFH 


0010H 


G 


??SEG 




150B0H 


150B0H 


0000H 


W 


STACK 


STACK 


(SiSB) 


150B0H 


0000H 


W 


MEMORY 


MEMORY 



r 



REMEMBER! 



• ADD A %JOB MACRO TO YOUR ROOT JOB 
; IOS JOB 

j 

%JOB(0, V OBJECT DIRECTORY SIZE 

0600H, 0FFFFJ, V POOL SIZE (MIN, MAX) 
0FFFFH, 0FFFFH, %' MAX OBJECTS AND TASKS 




0, 


% 


MAX JOB PRIORITY 


0:0, 


% 


EXCEPTION HANDLER ADDR, MODE 


0, 


% 


JOB FUGS 


130, 


% 


INIT TASK PRIORITY 


719:0 


% 


I NIT TASK ENTRY ADDRESS 


0, 


% 


INIT TASK DATA SEGMENT ADDRESS 


0:0, 200H % 


INIT TASK STACK ADDRESS, STACK SIZE 


0) 


% 


INIT TASK FLAGS 

THAT'S ALL FOLKS! 



V. 



THE GOOD NEWS! 



ICU WILL 

-CREATE ITABLE AND IDEVCF 
-CREATE A SUBMIT FILE TO ASSEMBLE 

LINK AND LOCATE THE BIOS 
-ADD A JOB MACRO TO THE ROOT JOB 
-COMPUTE THE STARTING ADDRESS FOR 

THE BIOS 
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******* LAB pouR (BIOS CONFIG THROUGH ICU) ******* 



IBJECTIVES: 



EXECUTE A GIVEN APPLICATION JOB, THAT WILL CALL UPON THE BIOS 
TO COMMUNICATE WITH A LIGHT BOX 

THE STUDENT WILL BUILD UPON LAB THREE TO CONFIGURE THE ALL THE 
PARTS NESSESARY TO EXECUTE THAT LAB 

THE STUDENT WILL USE THE INTERACTIVE CONFIGURATION UTILITY (ICU) 

5TEP1: 

USE THE ATTACH$FILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME"/LAB3) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAME"/LAB3 AS :LAB: 
* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 




'i"i'i'i' i * i " i " i ' i * i »>T 



m 



11111 



UBMiMiMikMMM 






*>-^' ; --: ; ..V 



SI ! a ; .;.;.v.;o| i mV i ;i; i . i ;m 

!{APPLI-- 



■> 



' X|.;.i. l l l .|.|. | .!A!.!. | .i.!,;.;.\;vXO;M i V i M ' M, 

^ V": |8IOSi v ■. 

«*.'.. .Tlfl'll Hi* " 

lis ta rt w mm 
;-;.:; : ;; ! ;:;; ]interrupt ||i |p 
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******* lab FOUR (BIOS CONFIG THROUGH ICU) ******* 



STEP2: 



THE (ICU) IS INVOKED BY TYPING THE FOLLOWING 
-ICU86 :LAB:ICU.DEF 

* WHERE ICU.DEF IS THE NAME OF THE FILE WE HAVE CHOSEN TO CONTAIN 
THE INFORMATION NEEDED TO CONFIGURE OUR O.S. 



WHEN THE ICU SIGN ON ENTER THE COMMAND C , TO MODIFY THE SCREENS 



STEP3: 



* TRY FILLING THE SCREENS WITHOUT LOOKING AT THESE FIRST, 
THEN MATCH YOUR ENTRIES TO THE ONES GIVEN HERE 

* IF YOU DO NOT UNDERSTAND AN ENTRY TYPE ? 

- E.G. OSP? <cr> 

* THE SCREEN FOR OUR LAB THREE CONFIGURATION FOLLOW 



Hardware 

(OSP) 80130 Operating System Extension (Yes/No) No 

(OTU) 80130 Timer Used (Yes/No) No 

(OPU) 80130 PIC Used (Yes/No) No 

roCD) 80130 Copyright = 1981 (Yes/No) Yes 

(BL) 80130 Base Address Location (40h-0FFFFh) OOOOH 

(BP) 80130 Base Port Address (0-OFFFFH) OOOOH 

(MP) 8259A Master Port (0-OFFFFH) OOCOH 

(MPS) Master PIC Port Separation (O-OFFH) 0002H 

(SIL) Slave Interrupt Levels P.-7/None) None 

(LSS) Level Sensitive Slaves H-7/Nonej None 

(LSP) Local Slave PICS (1-7/None) None 

(TP) 8253 Timer Port (0-OFFFFH) OODOH 

(CIL) Clock Interrupt Level (0-7) 0002H 

(CN) Timer Counter Number (0,1,2) OOOOH 

(CI) Clock Interval (0-OFFFFH msec) OOOAH 

(CF) Clock Frequency (0-OFFFFH khz) 04CDH 

(TPS) Timer Port Separation (0-OFFH) 0002H 

(NPX) Numeric Processor Extension (Yes/No) Yes 

(NIL) NPX Interrupt Level (Encoded) 0008H 



Memory 

Type : RAM = low, high 
Type : ROM = low, high 
Type : RAM = 0500H, F7FFH 
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******* lab FOUR (BIOS CONFIG THROUGH ICU) ******* 



Sub-systems 

(UDI) Universal Development Interface (Yes/No) No 

(HI) Human Interface (Yes/No) No • 

(AL) Application Loader (Yes/No) No 

(EIO) Extended I/O System (Yes/No) ' No 

(BIO) Basic I/O System (Yes/No) Yes 

(DB) . Debugger (Yes/No) No 

(TH) Terminal Handler (Yes/No) No 

(CA) Crash Analyzer (Yes/No) No 

(UIR) UDI in ROM (Yes/No) No 

(CAR) Crash Analyzer in ROM (Yes/No) No 

(RIR) Root Job in ROM (Yes/No) No 



3I0S 

(ASC) All Sys Calls in BIOS (Yes/No) Yes 

(ADP) Attach Device Task Priority (1-OFFH) 0081H 

(TF) Timinq Facilities Required f Yes/No) Yes 

(TTP) Timer Task Priority (0-OFFm 0081H 

(CON) Connection Job Delete Priority (0-OFFH) 0082H 

(ACE) Ability to Create Existinq Files (Yes/No) Yes 

f SMI) System Manager ID (Yes/No) Yes 

(CUT) Common Update Timeout (0-OFFFFH) 03E8H 

(CST) Control-Sequence Translation (Yes/No) Yes 

fPMI) BIOS Pool Minimum (0-OFFFFH) 0C00H 

(PMA) BIOS Pool Maximum (0-OFFFFH) 0C00H 

[BIR) Basic I/O System in ROM (Yes/No) No 



Jser Devices 

'OPN^ Object Code Path Name (1-45 characters) 

LABrDEVDRV.OBJ 
[DPU) Duib Source Code Path Name (1-45 characters) 



'DUP) Device and Unit Source 



LABrLBOXDUIB.SRC 

Code Path Name (1-45 characters) 

LABrLBOXDUIT.SRC 
;ND) Number of User Defined Devices ( 0-OFFH )' . 0001H 
[NDU) Number of User Defined Device-Units (0-OFFH^ 0002H 



8-13 



******* LAB FOUR (BIOS CONFIG THROUGH ICU) ******* 



Nucleus 

(ASC) All $ys Calls (Yes/No) Yes 

(PV) Parameter Validation (Yes/No) Yes 

(ROD) Root Object Directory Size (0 - OFFOh) 0028H 

(NITS) Minimum Transfer Size (O-OFFFFH) 0040H 

(DEH) Default Exception Handler (Yes/No/Deb/Use) Yes 

(NEH) Name of Ex Handler Object Module (l-32chs) 

(EM) Exception Mode ( Never /Program/Environ/All) Never 

(NR) Nucleus in ROM (Yes/No) No 

***** this JOB IS SUPPLIED TO CALL THE (BIOS) **** 
User Jobs 

(ODS) Object. Directory Size (0-OFFOH) 0032H 

(PMI) Pool Minimum (20H - OFFFFH) 0100H 

(PMA) Pool Maximum (20H - OFFFFH) FFFFH 

fMOB) Maximum Objects (1 - OFFFFH) • FFFFH 

(MTK) Maximum Tasks (1 - OFFFFH) FFFFH 

(MPR) Maximum Priority (0 - OFFH) 0000H 

(AEH) Address of Exception Handler (CS:IP) 0000H:0000H 

(EM) Exception Mode (Never/Proq/Environ/All) Never 

PV) Parameter Validation (Yes/No) Yes 

(TP) Task Priority (0-OFFH) 009BH 

(TSA) Task Start Address (CS:IP) 0104H:0002H 

DSB Data Segment Base (0-OFFFFH) 0000H 

(SSA) Stack Segment Address (SS:SP) 0000H:0000H 

(SS) Stack Size fO-OFFFFH) ■ 0200H 

(NPX) Numeric Processor Extension Used (Yes/No) No 

***** THIS job SUPPLIES THE INTERRUPT FOR THE MONITOR **** 
User Jobs 

(ODS) Object Directory Size (0-OFFOH) 0O0AH 

(PMI) Pool Minimum (20H - OFFFFH) 0030H 

(PMA) Pool Maximum (20H - OFFFFH) FFFFH 

(MOB) Maximum Objects (1 - OFFFFH) FFFFH 

(MTK) Maximum Tasks (1 - OFFFFH) FFFFH 

(MPR) Maximum Priority (0 - OFFH) 0000H 

(AEH) Address of Exception Handler (CS:IP) 0000H:0000H 

(EM) Exception Mode (Never/Prog/Environ/All) Never 

(PV) Parameter Validation (Yes/No) Yes 

(TP) Task Priority (O-OFFH) 0000H 

(TSA) Task Start Address (CS:IP) 0080H:0002H 

(DSB) Data Segment Base (0-OFFFFH) 0000H 

(SSA) Stack Segment Address (SS:SP) 0000H:0000H 

(SS) Stack Size (0-OFFFFH) 0200H 

(NPX) Numeric Processor Extension Used (Yes/No) No 
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******* LAB FOUR (BIOS CONFIG THROUGH ICU) ******* 

Includes and Libraries 
Path Name (1-45 Characters) 
fUDF) UDI Includes and Libs 

/RMX5.0/DUDI/ 
(HIF) Human Interface Includes and Libs 

/RMX5.0/DINCLSLIBS/ 
(EIF) Extended I/O Svstem Includes and Libs ' 

/RMX5.0/DINCLSLIBS/ 
(ALF) Application Loader Includes and Libs 

/RMX5.0/DLOADER/ 
(BIF) Basic I/O System Includes and Libs 

/RMX5.0/DINCLSLIBS/ 
(THF) Terminal Handler and Debugger Includes and Libs 

/RMX5.0/DDEBTH/ 
(NUF) Nucleus and Root Job Includes and Libs 

/RMX5.0/DNUCLUS/ 
(ILF) Interface Libraries 

/RMX5.0/DUTILS/ 
(CAF) Crash Analyzer Includes and Libs 

/RMX5.0/DUDI/ 
(DTF) Development Tools Path Names 

/LANG/ 

3enerate File Names 

r ile Name (1-55 Characters) 

(ROF) ROM Code File Name 

: LAB: NONE 
(RAF) RAM Code File Name 

:LAB:RMX86 

STEP4: 

AFTER YOU ENTER ALL OF THE SCREENS ENTER G TO GENERATE 
EXIT THE ICU 

SUBMIT THE ICU.CSD FILE TO GENERATE YOUR SYSTEM 
-SUBMIT :LAB: ICU.CSD 
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******* lab pour (BIOS CONFIG THROUGH ICU) ******* 

STEP5: 

YOU MUST NOW ADD THE USER JOB , AND- THE SDB TO THE SYSTEM, 
USING THE LIB86 UTILITY 

-LIB86 

DELETE :LAB:RMX86(STARTM0D) 

ADD : LAB: LAB JOB to :LAB:RMX86 

DELETE :LAB:RMX86(INT3TASKM0D) 

ADD /DINT3/INT3JOB to :LAB:RMX86 
EXIT 

STEP6: 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /"TEAM NAMEVLAB3/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY, 
f COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
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CHAPTER 9 
EXTENDED I/O SYSTEM 

Configuration 

f TABLES 
• ICU86 



r 



K 



STEPS IN BUILDING THE EXTENDED I/O SYSTEM 

1) THREE CONFIGURATION FILES ARE NEEDED (ETABLE.A86.EDEVCF.A86, 
EJ0BCF.A86) 

2) ASSEMBLE EACH CONFIGURATION TABLE 

3) LINK AND LOCATE THE EI OS 




• ETABLE CONTAINS SYSTEM CALLS 

• EDEVCF CONTAINS DEVICES TO 
BE LOGICALLY ATTACHED BY 
EIOS 

• EJOBCF CONTAINS DESCRIPTION 
OF CHILD 10 JOBS 

• REFER TO CONFIGURATION 
MANUAL THROUGH THE REST 
OF THIS CHAPTER 
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ETABLE.A86 



%RQCREATEIOJOB- 
%RQEXITIOJOB 

%RQLOGICALATTACHDEVICE 
SRQLOGICALDETACHDEVICE 

%RQSCREATEFILE 

$RQATTACHFILE 

%RQDELETECONNECTION 

XRQLOOKUPCONNECTION 

ZRQCATALOGCONNECTION 

%RQUNCATALOGCONNECTION 

ZRQSCREATED I RECTORY 

%RQSDELETEFILE 

%RQSRENAMEFILE 

%RQSCHANGEACCESS 

%RQSOPEN 

%RQSCLOSE 

%RQSOPEN 

%RQSREADMOVE 

%RQSWRITEMOVE 

%RQSSEEK 

%RQSTRUNCATEFILE 

%RQSGETFILESTATUS 

%RQSGETCONNECTIONSTATUS 

%RQSSPECIAL 




•JOB INTERFACE 



ONFIGURATION INTERFACE 



SYNCHRONOUS INTERFACE 
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f EDEVCF.A86 "X 

; BYTE-BUCKET 

%DEV_INFO_BLOCKC BBS 'BBS PHYSICAL) 
; TERMINAL 

%DEV_INFO_BLOCK('TO/TO', PHYSICAL) 
; ' 215 WINCHESTER - PRlAM, UNIT 0, DRIVE 

%DEV_INFO_BLOCK('WD0'/IW0SNAMED) • LOGICALLY ATTACH 

i 215 WINCHESTER FLOPPY DS/DD, UNIT 0, DRIVE IW0 AS :WD0: 

%DEV- I NFO-BLOCK ( ' FD0, ' WFDD0, NAMED ) 
; STREAM 

%D EV- 1 NFO-BLOCK ( 'STREAM' /STREAM', STREAM) 
; LP 

%DEV- 1 NFO-BLOCKC STREAM '/STREAMS STREAM) 

%END DEV CONFIG (1024) 



I 
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/ ^ 

EJ0BCF.A86 

USER 'WORLD' DEFINITION 

%IO_USER( 'WORLDS 0FFFFH) •- " ' 0WNER ID 

EIOS TEST JOB 

%IO_JOB('TO', 'WORLDS 260H, 0FFFFH, 0:0, 3, 155, 2000:2, 0, 0:0, 1200, 0) 

%END_IO_JOB_CONFIG(i»0) ^JS 

YOU PROVIDE ADDRESS 



V 
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LOCATE ADDRESSES \ 
• THE LOCATE PROGRAM GENERATES A MAP FILE CALLED /RMX/DEI0S/EI0S.MP2 

-t EXAMINING THE MAP WE OBTAIN THE ENDING ADDRESS OF THE EIOS 
(USED FOR LOCATING THE NEXT JOB) 



MEMORY MAP OF MODULE EIOENT 



SEGMENT 


MAP 










START 


STOP 


LENGTH 


ALIGN 


NAME 


CLASS 


00200H 


00216H 


0017H 


A 


(ABSOLUTE) 




182B0H 


1D0D7H 


2E28H 


W 


CODE 


CODE 


1D0D8H 


1D0DFH 


0008H 


W 


JOB SEG 


CODE 


1D0E0H 


1D117H 


0038H 


W 


SYNCHRONOUS_SE 
-G 
CONFIGURATION 


CODE 


1D118H 


1D11BH 


0004H 


W 


CODE 










-SEG 




1D11CH 


1D129H 


000EH 


W 


GROUPUSER SEG 


CODE 


1D12AH 


1D133H 


000AH 


W 


ALLOCATION SEG 


CODE 


1D134H 


1D143H 


0010H 


W 


DATA 


DATA 


1D150H 


1D150H 


0000H 


G 


??SEG 




1D150H 
p~ <lD150H> 


1D150H 
1D150H 


0000H 
0000H 


W 
W 


STACK 
MEMORY 


STACK 
MEMORY 
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THE SUBMIT FILE (86/330 STYLE) 

ASM86 /RMX/DEI0S/ETABLE330.A86 PRINT(/RMX/DEIOS/ETABLE330.LST) 8 
W0RKFILES(:WORK:,:WORK:) OBJECT(/RMX/DEIOS/ETABLE.OBJ) 

ASM86 /RMX/DEIOS/EDEVCF330 .A86 PRINT(/RMX/DEIOS/EDEVCF330. LST) 8 
WORKFILES(:WORK:,:WORK:) OBJECT(/RMX/DEIOS/EDEVCF.OBJ) 

ASM86 /RMX/DEIOS/EJOBCF330.A85 PRINT(/RNX/DEI0S/EJ0BCF332.LST) S 
WORKFILES(:WORK:,:WORK:) OBJECT(/RMX/DEIOS/EJOBCF.OBJ) 

; LINK AND LOCATE EIOS INITIALIZATION CODE AND SYSTEM CALLS 

LINK86 & 

/RMX/DEIOS/EIOS.LIB(EIOENT), 8 

/RMX/DEIOS/ET ABLE. OBJ, S 

/RMX/DEIOS/EDEVCF.OBJ, 8 

/RMX/DEIOS/EJOBCF.OBJ, & 

/RMX/DEIOS/EIOS.LIB, 8 

/RMX/DEIOS/EPIFC.LIB, 8 

/R1X/DBI0S/IPIFC.LIB, 8 

/RflX/DNUCLUS/RPlFC.LIB 8 

TO /RMX/DEIOS/EIOS.LNK 8 

MAP PRINT(/RMX/DEI0S/EI0S.MP1)8 

NOPUBLICS EXCEPT (RQElOSINinASK, RQEIOSINITERROR) 

L0C86 8 

/RMX/DEIOS/EIOS,LNK TO /RMX/DEIOS/EIOS 8 
MAP PRINT(/RMX/DEI0S/EI0S.MP2) 8 
NOLINES NOCOMMENTS NOSYMBOLS 8 
SEGSIZE(STACK(0)) 8 

ORDER (CLASSES (CODE, DATA)) 8 
ADDRESSES (CLASSES (CODE(0Z1) ) ) 
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^^ 

' ROOT JOB MACRO 



• REMEMBER TO ADD A %JOB MACRO TO YOUR ROOT JOB 
EIOS JOB 



% JOB (10, 




%/OBJECT DIRECTORY SIZE 


0150H, 


0FFFFH, 


%'POOL SIZE (MIN , MAX) 


0FFFFH, 


0FFFFH, 


%'MAX OBJECTS AND TASKS 


130, 




%'MAX JOB PRIORITY 


0:0, 3, 




I' EXCEPTION HANDLER ADDR, MODE 


0, 




%'JOB FLAGS 


150, 




%'INIT TASK PRIORITY 


1A2B:0, 




%'INIT TASK ENTRY ADDRESS 


0, 




%'INIT DATA SEGMENT ADDRESS 


0:0, 250H, 


%'INIT TASK STACK ADDRESS, STACK SIZE 


0) 




%'INIT TASK FLAGS 
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tCU 86 ^ 



ICU86 WILL 



- CREATE ETABLE, EDEVCF AND EJOBCF 

- CREATE A SUBMIT FILE THAT INCLUDES ASSEMBLY 
LINKING AND LOCATION OF THE EIOS 

- ADD A JOB MACRO TO THE ROOT JOB 

- COMPUTE THE STARTING ADDRESS OF THE EIOS 



I 
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******* LAB FIVE (EIOS CONFIG THROUGH ICU) ******* 



IBJECTIVES: 



EXECUTE A GIVEN APPLICATION JOB, THAT WILL CALL UPON THE EIOS TO 
COMMUNICATE WITH A TERMINAL AND A FILE IN A FLOPPY 

THE STUDENT WILL BUILD UPON LAB TWO TO CONFIGURE ALL THE 
PARTS NESSESARY TO EXECUTE THAT LAB 

THE STUDENT WILL USE THE INTERACTIVE CONFIGURATION UTILITY (ICU) 

5TEP1: 

. USE THE ATTACH$FILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME"/LAB2) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAME"/LAB2 AS :LAB: 
* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 






m 



Hll! 



(ROOT) 



W 



T 



(APPLICATION) 



ART2 

ask |y 






START2 
TASK 



EIOLAB 
TASK 
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******* lab FIVE (EIOS CONFIG THROUGH ICU) ******* 



STEP2: 



THE (ICU) IS INVOKED BY TYPING THE FOLLOWING 
-ICU86 :LAB:ICU.DEF 

* WHERE ICU.DEF IS THE NAME OF THE FILE WE HAVE CHOSEN TO CONTAIN 
THE INFORMATION NEEDED TO CONFIGURE OUR O.S. 



WHEN THE ICU SIGN ON ENTER THE COMMAND C , TO MODIFY THE SCREENS 



STEP3: 



* TRY FILLING THE SCREENS WITHOUT LOOKING AT THESE FIRST, 
THEN MATCH YOUR ENTRIES TO THE ONES GIVEN HERE 

* IF YOU- DO NOT UNDERSTAND AN ENTRY TYPE ? 

- E.G. OSP? <er> 

* THE SCREEN FOR OUR LAB TWO CONFIGURATION FOLLOW 



Hardware 

(OSP) 80130 Operating System Extension (Yes/No) No 

80130 Timer Used (Yes/No) No 

80130 PIC Used (Yes/No) No 

80130 Copyright = 1981 (Yes/No) Yes 
80130 Base Address Location (40h-0FFFFh) OOOOH 

80130 Base Port Address (0-OFFFFH) OOOOH 

8259A Master Port (0-OFFFFH) OOCOH 

(MPS) Master PIC Port Separation (0-OFFH) 0002H 

(SIL) Slave Interrupt Levels (1-7/None) None 

Level Sensitive Slaves (1-7/None) None 

Local Slave PICS (1-7/None) None 

8253 Timer Port (0-OFFFFH) OODOH 

Clock Interrupt Level (0-7) 0002H 

Timer Counter Number (0,1,2) OOOOH 

Clock Interval (0-OFFFFH msec) OOOAH 

Clock Frequency rO-OFFFFH khz) 04CDH 

Timer Port Separation (0-OFFH) 0002H 

Numeric Processor Extension (Yes/No) Yes 

NPX Interrupt Level (Encoded) 0008H 



(OTU) 
(OPU) 
(OCD) 
(BL) 
BP) 
MP) 



(LSS) 

(LSP) 

(TP) 

(CIL) 

(CN) 

(cn 

(CF) 
(TPS) 
(NPX) 
(NIL) 
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******* LAB FIVE f EI0S CONFIG THROUGH I CM ******* 



Memory 

Type : RAM = low, high 

Type : ROM = low, high 

Type : RAM = 0500H, F7FFH 



Sub-systems 

(UDI) Universal Development Interface (Yes/No) No 

fHI) Human Interface (Yes/No) No 

f AL) Application Loader (Yes/No) No 

f EIO) Extended I/O System (Yes/No) Yes 

(BIO) Basic I/O System (Yes/No) Req 

f DB ) Debugger (Yes/No) No 

(TH) Terminal Handler (Yes/No) No 

(CA) Crash Analyzer (Yes/No) No 

(UIR) UDI in ROM (Yes/No) No 

fCAR) Crash Analyzer in ROM (Yes/No) No 

(RIR) Root Job in ROM (Yes/No) No 



EIOS 

(ASC) All Sys Calls in EIOS Yes 

fABR) Automatic Boot Device Recognition /Yes/No) No 
(DLN) Default System Device Logical Name (1-12 characters) 
fDPN) Default System Device Physical' Name (1-1? characters) 

fDFD) Default System Device File Driver (Phys/Str/Named) Named 

fDO) Default System Device Owners ID (0-OFFFFH) 0000H 

[EBS) Internal Buffer Size (0-OFFFFh) 0400H 

(DDS) Default 10 Job Directory Size (5-0FF0h) 0020H 

[ITP) Internal EIOS Task's Priorities (0-OFFH) 0083H 

r PMI) EIOS Pool Minimum (0-OFFFFH) 0180H 

[PMA) EIOS Pool Maximum (0-OFFFFH) FFFFH 

r EIR) Extended I/O System in ROM (Yes/No) No 
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******* LAB FIVE (EIOS CONFIG THROUGH ICU) ******* 



I/O Users 

User : user name, Owner-ID (, ID, ID, ID, ID) 

User : LAB2,0000H,FFFFH 



Logical Names 

Logical Name : logical_name,device__name,file_driver, owners-id 

(1-12 Chars ,1-14 Chars , Physical/Stream/Named, 0-OFFFFH) 

BB, BB, Physical, 0000H 

STREAM, STREAM, Stream, OOOOH 

TO, TO, Physical, OOOOH 



Logical Name 
Logical Name 
Logical Name 



Logical Name : FDO, WFDDO, Named, OOOOH 



I/O Jobs 

(IJD) I/O Job Default Prefix (Loqical Name) TO 

(DU) Default User (I/O User) LAB2 

(PMI) Pool Minimum (20H - OFFFFH) 0260H 

(PMA) Pool Maximum "(20H - OFFFFH) FFFFH 

(AEH) Address of Exception Handler (CS:IP) OOOOHrOOOOH 

(EM) Exception Mode (Never/Prog/Environ/All) Never 

(PV) Parameter Validation (Yes/No) Yes 

(TP) Task Priority (0-OFFH) ' 009BH 

(TSA) Task Start Address (CS:IP) 0104H:0002H 

(DSB) Data Segment Base (0-OFFFFH) OOOOH 

(SSA) Stack Segment Address (SS:SP) OOOOHrOOOOH 

SS) Stack Size (0-OFFFFH) 0300H 

(NPX) Numeric Processor Extension Used (Yes/No) No 



BIOS 

(ASC) All Sys Calls in BIOS (Yes/No) Yes 

(ADP) Attach Device Task Priority (1-OFFH) 0081H 

(TF) Timing Facilities Required (Yes/No) Yes 

(TTP) Timer Task Priority (0-OFFH) 0081H 

(CON) Connection Job Delete Priority (0-OFFH^ 0082H 

(ACE) Ability to Create Existing Files (Yes/No) Yes 

(SMI) System Manaqer ID (Yes/No) Yes 

(CUT) Common Update Timeout (0-OFFFFH) 03E8H 

(CST) Control-Sequence Translation (Yes/No) Yes 

(PMI) BIOS Pool Minimum (0-OFFFFH) 0C00H 

(PMA) BIOS Pool Maximum (0-OFFFFH^ 0C00H 

(BIR) Basic I/O System in ROM (Yes/No) No 
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******* LAB FIVE fEIOS CONFIG THROUGH ICU) ******* 



Intel Terminal Driver 

(IIL) Input Interrupt Level ( Encoded) 

(OIL) Output Interrupt Level (Encoded) 

(UDP) USART Data Port (0-OFFFFH) 

(USP USART Status Port (0-OFFFFH) 

(IRP) 8253 Input Rate Port (0-OFFFFH) 

ICP) 8253 Input Control Port (0-OFFFFH) 

(IRC) 8253 Input Counter Number (0-2) 

(IRM) Input Rate Maximum (0-OFFFFFFFFH) 

(ORP) 8253 Output Rate Port (0-OFFFFH) 

(OCP) 8253 Output Control Port (0-OFFFFH) 

(ORC) 8253 Output Counter Number (0-2) 

(ORM) Output Rate Maximum (O-OFFFFFFFFH) 



0068H 

0078H 

00D8H 

OODAH 

00D4H 

00D6H 

0002H 

00012C00H 

0000H 

0000H 

0000H 

00000000H 



Intel Terminal Driver Unit Information 

(NAM) Unit Info Name (1-17 Chars) tO_uinfo 

(LEM) Line Edit Mode (Trans/Normal/Flush) Normal 

(ECH) Echo Mode (Yes/No) Yes 

(IPC) Input Parity Control (Yes/No) No - 

(OPC) Output Parity Control (Yes/No) No 

(OCC) Output Control in Input (Yes/No) Yes 

(OSC) OSC Controls (Both/In/Out/Neither) Both 

(DUP) Duplex Mode (Full/Half) Full 

(TRM) Terminal Type (CRT/Hard Copy) CRT 

(MO Modem Control (Yes/No) No 

(RPC) Read Parity Checking (See Help/0-3) 0000H 

(WPC) Write Parity Checking (See Help/0-4) 0000H 

(BR) Baud Rate (0-OFFFFH) 2580H 

(SN) Scroll Number (0-OFFFFH) 0012H 



Intel Terminal Driver Device-Unit Information 

(NAM) Device-Unit Name (1-13 chars) 

(UN) Unit Number on this Device (0-OFFH) 

(UIN) Unit Info Name (1-17 Chars) 

(MB) Max Buffers (0-OFFH) 



TO 

0000H 
tO_uinfo 
0000H 
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******* LAB FIVE (EIOS CONFIG THROUGH ICU) ******* 



Intel iSBC 215/218 Driver 

(IL) Interrupt Level (Encoded Level) 

(ITP) Interrupt Task Priority (0-OFFH) 

(WIP) Wakeup I/O Port (0-OFFFFH) 



0058H 
0082H 
0100H 



Intel iSBC 215/218 Unit Information 

(.NAM) Unit Info Name (1-17 Chars) uinfo_215fd 

MR) Maximum Retries (0-OFFFFH) 0009H 

CS) Cylinder Size (0-OFFFFH) OOOOH 

(NO Number of Cylinders (0-OFFFFH) 004DH 

(NFH) Number of Fixed Platters/Disk (0-OFFH) OOOOH 

(NRH) Number of Remove Platters/Disk (0-OFFH) 0002H 

(NS) Number of Sectors/Track (0-OFFFFH) 001AH 

(NAC) Number of Aux. Cylinders (0-OFFH) OOOOH 

(SSN) Startinq Sector Number (0-OFFFFFFFFH) • 00000000H 

(BTI) Bad Track Information (Yes/No) Yes 



Intel iSBC 215/iSBX 218 Device-Unit Information 

(NAM) Device-Unit Name (1-13 chars) WFDDO 

(PFD) Physical File Driver Required (Yes/No) Yes 

(NFD) Named File Driver Required (Yes/No) Yes 

(SDD)- Single or Double Density Disks (Single/Double) Double 

(SDS) Single or Double Sided Disks (Single/Double) Double 

EFI) 8 or 5 Inch Disks (8/5) 8 

(GRA) Granularity (0-OFFFFH) 0100H 

(DSZ) Device Size fO-OFFFFFFFFH) 000F9700H 

(UN) Unit Number on this Device (0-OFFH) 0008H 

(UIN) Unit Info Name (1-17 Chars) uinfo_215fd 

(UDT) Update Timeout (0-OFFFFH) 0064H 

(NB) Number of Buffers (nonrandom = 0/rand = 1-OFFFFH) 00O6H 

(FUP) Fixed Update (True/False) True 

(MB) Max Buffers (0-OFFH) OOFFH 

Nucleus 

(ASC) All Sys Calls (Yes/No) Yes 

(PV) Parameter Validation (Yes/No) Yes 

(ROD) Root Object Directory Size (0 - OFFOh) 0028H 

(MTS) Minimum Transfer Size (0-OFFFFH) 0040H 

(DEH) Default Exception Handler (Yes/No/Deb/Use) Yes 

(NEH) Name of Ex Handler Object Module (l-32chs) 

(EM) Exception Mode ( Never /Proqram/Environ/All) Never 

(NR) Nucleus in ROM (Yes/No) No 
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******* LAB FIVE (EIOS CONFIG THROUGH ICU) ******* 



Jser Jobs 

[ODS) Object Directory Size (O-OFFOH) OOOAH 

PMI) Pool Minimum (20H - OFFFFH) 0030H 

PMA) Pool Maximum (20H - OFFFFH) FFFFH 

MOB) Maximum Objects fl - OFFFFH) FFFFH 

MTK) Maximum Tasks (1 - OFFFFH) FFFFH 

MPR) Maximum Priority (0 - OFFH) OOOOH 

AEH) Address of Exception Handler (CS:IP) OOOOHrOOOOH 
EM) Exception Mode f Never /Prog/Environ/All) Never 

PV) Parameter Validation (Yes/No) Yes 

TP) Task Priority (0-OFFH) OOOOH 

TSA) Task Start Address (CS:IP) 0080H:0002H 

DSB) Data Segment Base (0-OFFFFH) OOOOH 

SSA) Stack Seqment Address fSS:SP) 0000H:0000H 

SS) Stack Size (0-OFFFFH) 0200H 
NPX) Numeric Processor Extension Used (Yes/No) No 



[ncludes and Libraries 
>ath Name (1-45 Characters) 
UDF) UDI Includes and Libs 

/RMX5.0/DUDI/ 
HIF) Human Interface Includes and Libs 

/RMX5.0/DINCLSLIBS/ 
EIF) Extended I/O System Includes and Libs 

/RMX5.0/DINCLSLIBS/ 
ALF) Application Loader Includes and Libs 

/RMX5.0/DL0ADER/ 
BIF) Basic I/O System Includes and Libs 

/RMX5.0/DINCLSLIBS/ 
THF) Terminal Handler and Debugger Includes and Libs 

/RMX5.0/DDEBTH/ 
NUF) Nucleus and Root Job Includes and Libs 

/RMX5.0/DNUCLUS/ 
ILF) Interface Libraries 

/RMX5.0/DUTILS/ 
CAF) Crash Analyzer Includes and Libs 

/RMX5.0/DUDI/ 
DTF) Development Tools Path Names 

/LANG/ 



Generate File Names 
: ile Name (1-55 Characters) 
ROF) ROM Code File Name 

RAF) RAM Code File Name 



: LAB: NONE 
:LAB:RMX86 
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******* LAB FIVE (EIOS CONFIG THROUGH ICU) ******* 
STEP4: 

AFTER YOU ENTER ALL OF THE SCREENS ENTER G TO GENERATE 
EXIT THE ICU 

SUBMIT THE ICU.CSD FILE TO GENERATE YOUR SYSTEM 
-SUBMIT :LAB: ICU.CSD 

STEP5: 



YOU MUST NOW ADD THE USER JOB AND THE SDB TO THE SYSTEM, 
USING THE LIB86 UTILITY 



-LIB86 

DELETE :LAB:RMX86(STARTM0D) 

ADD :LAB:LABJOB to :LAB:RMX86 

DELETE :LAB:RMX86(INT3TASKMOD) 

ADD /DINT3/INT3J0B to :LAB:RMX86 
EXIT 

STEP6: 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /"TEAM NAMEVLAB2/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 
( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
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CHAPTER 10 
THE IRMX 86 APPLICATION LOADER 



t LOADER FUNCTION 

• TYPES OF LOADABLE CODE 

• SYSTEMS WITHOUT THE EIOS 

• LOADER RESULT SEGMENT 

• SYSTEMS WITH THE EIOS 



r 



APP LOADER FUNCTION 
• THE APP LOADER MOVES CODE FROM SECONDARY STORAGE INTO RAM 




APP 
LOADER 




NEW 
CODE 



V 



V 
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NAMED FILES 

• THE APP LOADER CAN LOAD OBJECT CODE FROM ANY DEVICE 
THAT SUPPORTS iRMX 86 NAMED FILES 

• THE iRMX 86 O.S. IS CURRENTLY DELIVERED WITH SUPPORT 
FOR THE FOLLOWING DEVICES 

ISBC 204 iSBC 218 
ISBC 206 • iSBC 220 
I SBC 215 i SBC 254 

• IT WILL ALSO SUPPORT CUSTOM DEVICES, FOR WHICH YOU 
HAVE WRITTEN A DEVICE DRIVER 
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TYPES OF- LOADABLE CODE 



V. 



t ABSOLUTE (ABS) 

- CODE IS LOCATED AT AN ABSOLUTE LOCATION IN MEMORY 
WITH THE L0C86 UTILITY PROGRAM 

- THE USER "MUST" HAVE THIS LOCATION RESERVED 
AT CONFIGURATION 

- THE LOADER ALWAYS LOADS THE CODE AT THE SAME 
ABSOLUTE LOCATION 

- PL/M MODELS MAY BE MEDIUM, LARGE OR COMPACT 




10-3 



r 



"\ 



TYPES OF LOADABLE CODE (CONTINUED) 
• POSITION INDEPENDENT CODE (PIC) 

- CODE IS NEVER LOCATED, INSTEAD THE BIND OPTION IS USED 
WHEN LINKING WITH THE LINK86 UTILITY PROGRAM 

- PIC CODE CAN BE LOADED INTO ANY MEMORY LOCATION 

- THE LOADER OBTAINS iRMX 86 SEGMENTS "RUNTIME" AND 
LOADS PIC INTO THE SEGMENTS 

- PIC IS RESTRICTED TO USE BY TASKS THAT HAVE ONLY 
ONE CODE SEGMENT AND ONE DATA SEGMENT 

- PL/M MODEL IS COMPACT ONLY 
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TYPES OF LOADABLE CODE (CONTINUED) 



V 



• LOAD TIME LOCATABLE (LTD 

- SIMILAR TO PIC CODE, LINK WITH BIND, CODE MAY BE 
LOADED ANYWHERE IN MEMORY 

- CAN BE USED BY TASKS HAVING MORE THAN ONE CODE 
SEGMENT OR MORE THAN ONE DATA SEGMENT 

- PL/M MODELS MAY BE MEDIUM, LARGE OR COMPACT 
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PL/M MODELS AND TYPES OF CODE 



LARGE 



t 

ABS 
'LINK86 
•L0C8S 




MEDIUM 




LTL 
LINK86 (BIND) 




COMPACT 



PIC 
♦LINK86(BIND) ' 
*D0 NOT USE INITIAL OR DAJ_A 

TO INITIALIZE A POINTER 
•USE NOINTVECTOR FOR ANY 

INTERRUPT PROCEDURE 



IF YOU DON'T HAVE AN 86-BASED DEVELOPMENT SYSTEM YOU CAN 
GENERATE ONLY ABS CODE. 
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SYSTEMS WITHOUT THE EIOS 



• THE APPLICATION LOADER LIVES IN YOUR SYSTEM AS 
A FIRST LEVEL JOB. 








• YOU CALL THE LOADER THROUGH RQALOAD 

• THE LOADER CALLS THE BIOS TO LOAD THE CODE 



r 
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LOADER SYSTEM CALLS 

• RQALOAD SYSTEM CALL 

- A SYNCHRONOUS 

- LOADS FROM A FILE INTO MEMORY 

- THE FORM OF THE CALL IS 



CALL RQALOAD (FILE$CONN, RSP$MBOX, aSTATUS), 
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THE LOADER RESULT SEGMENT 

• THE LDRS IS RETURNED TO THE RESPONSE MAILBOX AFTER THE 
LOADER HAS COMPLETED THE LOAD FUNCTION. 



"\ 



EXCEPT$CODE 



RECORD$COUNT 



REC$TYPE 



NUMBER$UNDEFINED$REFS 



INIT$IP 



C0DE$SE6$BASE 



STACK$SE6$BASE 



STACK$OFFSET 



STACK$SEG$BASE 



STACK$SIZE 



CATA$SEG$BASE 



I 



t THE LOADING TASK USES THE INFORATION IN THE LDRS TO 
CREATE A TASK OR CREATE A JOB. 
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CODE ENTRY POINTS 



V 



• THE ENTRY POINT IS WHERE EXECUTION BEGINS AFTER THE 
CODE IS LOADED. 

t THE LOADER MUST GET THIS ENTRY POINT FROM THE LOADABLE CODE. 

t THERE IS ONE CIRCUMSTANCE IN WHICH THE LOADER DOES NOT 
REQUIRE AN ENTRY POINT. 

- THE LOADABLE CODE IS ABSOLUTE, AND 

- THE LOADING TASK KNOWS THE ENTRY POINT, AND 

- THE LOADING TASK USES THE RQALOAD SYSTEM CALL 
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USING RQALOAD SYSTEM CALL 



"N 



COMPACT 



V 




MAIN 

-SEGSIZE (STACKS) )ON L0C86 

-LDRS IS OK TO CREATE 
TASK OR JOB 

-USE DYNAMIC STACK,S I ZE=128 
-"DEBUGGER OVERFLOW 



MAIN 
-SEGSIZE(STACK(#)) ON 

-LORS IS OK TO CREATE 
TASK OR JOB 



LOC 86 



PROCEDURE 
-MUST BE PLM URGE MODEL 

-USE START (PUBLIC SYMBOL) 
ON L0C86 

-USE DYNAMIC STACKS I ZE=512 
-SEGSIZE(STACK(0))ON L0C8B 
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LOADABLE PROCEDURES 

t WRITE SOURCE CODE AS A PROCEDURE ONLY IF: 

- CODE IS (ABS), WITHOUT USING NOINITCODE IN L0C86 

- YOU ARE LOADING A TASK(S) AND NOT A JOB 

- YOU ARE USING THE RQALOAD SYSTEM CALL 

• PROCEDURE EXAMPLE 

FLASHMOD-.DO; 

$ I NCLUDE ( /RMX/DNUCLUS/NUCLUS . EXT ) 
DECLARE STATUS WORD; 

FLASHTASK: PROCEDURE PUBLIC- 
DO FOREVER; 

OUTPUT (9CH) = 0FFH; 
CALL RQSLEEP(50, aSTATUS); 
OUTPUT (9CH) = 0; 
CALL RQSLEEP(5D, aSTATUS); 
END; /"END OF FOREVERV 
END; /"END OF TASK*/ 
END; /"END OF MODULE*/ 



V. 
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LOADABLE MAIN MODULES 

• IF CODE IS LTL OR PIC THEN CODE MUSI BE A MAIN MODULE 

• A MAIN MODULE CONTAINS EXECUTABLE STATEMENTS AT THE 'OUTERMOST 
LAYER OF THE MODULE 

• WHEN LINKING OR LOCATING USE "SEGSIZE(STACK(###) )" TO 
ASSIGN THE APPROPRIATE STACKS I ZE 

• MAIN MODULE EXAMPLE 
FLASHMOD : DO; 

$INCLUDE(/RMX/DNUCLUS/NUCLUS.EXT) 
DECLARE STATUS WORD; 
DO FOREVER; 

OUTPUT (09CH) = 0FFH; 
CALL RQSLEEP(25, 3STATUS); 
OUTPUT (09CH) = 0; 
CALL RQSLEEP(25, aSTATUS); 
END; /*END OF FOREVER*/ 
END; /*END OF MODULE*/ 



V 
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/ ^ 

QUIZ! 



1) NAME TYPES OF CODE 



2) WHERE DOES THE LDRS COME FROM? 

3) NAME ONE ADVANTAGE OF USING A PROCEDURE OVER A MAIN MODULE? 
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SYSTEMS WITH THE EIOS (THE EASY WAY) 



"\ 




• THE USER CALLS THE LOADER THROUGH RQALOADIOJOB OR RQSLOADIOJOB 

• THE LOADER CALLS THE EIOS ON YOUR BEHALF (YOU MUSI BE AN IOJOB) 
TO LOAD THE CODE 
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SYNCHRONOUS LOADER SYSTEM CALL 



RQSLOADIOJOB 

- SYNCHRONOUS 

- LOADS CODE INTO MEMORY, STARTS NEW 10 JOB 

- THE FORM OF THE CALL IS 



JOB$TOKEN = RQSLOADIOJOB (3(10/ :FD0: FLASH' ), 

0,0FFFFH, 
0, 
0, 

130, 
0, 

RSPMBOX, 
3STATUS); 



/'PATH PTRV 
/•POOL LOWER, UPPER*/ 
/•EXCEPT HANDLER*/ 
/•JOB FLAGS*/ 
/•TASK PRIORITY*/ 
/•TASK FLAGSV 
/•RESPONSE MAILBOX*/ 



V 
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THE TERMINATION MESSAGE 



~\ 



• WHEN THE NEWLY CREATED 10 JOB MAKES AN RQEXITIOJOB CALL 

- THE PARENT JOB RECEIVES A TERMINATION MESSAGE 

- THE PARENT JOB WAITS AT THE RSPMBOX FOR THIS MESSAGE 

- THE FORMAT OF THE MESSAGE IS 



TERMINATION CODE 




USER$FAULT$CODE 




JOB$TOKEN 




DATA$LENl 




DATAC) ^ 



• REFER TO RQCREATEIOJOB IN EIOS REFERENCE MANUAL. 
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RQSLOADIOJOB 



LARGE 



ABS 
(NO INITCODE) 



COMPACT 




MAIN 
-SEGSIZE(STACK(#)) 



V 
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CHAPTER 1 1 
APPLICATION LOADER 

Configuration 



r 



v 



STEPS IN BUILDING THE APPLICATION LOADER 

1) A CONFIGURATION FILE IS NEEDED (LC0NFG.P86) 

2) COMPILE (PLM86) THE CONFIGURATION FILE 

3) LINK AND LOCATE THE APP LOADER 



"N 




) 



ALTER LC0NFG.P86 



• REFER TO CONFIGURATION 
GUIDE THROUGH THE REST 
OF THIS CHAPTER 



li-i 



r 
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LOADERSCONFIG: DO; 

DECLARE BUF$SIZE 
DECLARE RDBUF$SIZE 

DECLARE LBUF$SIZE 
DECLARE L$RDBUF$SIZE 



LC0NFG.P86 



LITERALLY '1024'; /• BYTES 
LITERALLY '1024'; /• BYTES 



A 



WORD PUBLIC DATA(BUF$SIZE + 11); 
WORD PUBLIC DATA(RDBUF$SIZE); 



THE SIZE OF THE 
LOADER INTERNAL 
BUFFERS FOR OBJECT 
RECORDS. 

THE SIZE OF THE 
INPUT BUFFERS 



DECLARE$DEFAULT$MEMPOOL WORD PUBLIC DATA(20i?H); /'PAGES*/ 
END LOADER$CONFIG; 

\ 

L$DEFAULT$MEMPOOL SELECTS THE DYNAMIC MEMORY 
(MEMPOOL) REQUIREMENT FOR THE OBJECT-FILE 
BEING LOADED. 

NOTE: THIS VALUE IS SPECIFIED IN PAGES 
(1 PAGE = 16 BYTES). 

THIS PARAMETER HAS NO EFFECT ON 
'RQ$A$LOAD' SYSTEM CALL. 
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THE SUBMIT FILE (86/330 STYLE) 



"\ 



PLM86 /RMX/DLOADER/LCONFG330.P86 COMPACT OPTIMIZED) NOTYPE ROM & 

OBJECT(/RMX/DLOADER/LCONFG.OBJ) PRINT(/RMX/DLOADER/LCONFG330.LST) WORKFILES(:WORK:,:WORK:) 



LINK86 /RMX/DLOADER/LOADR|gtLIB(LDRINT), J 
/RMX/DLOADER/LCONFG. 
/RMX/DLOADER/LOAD 
/RMX/D LOADER/LJBC 
/RMX/DLOADER/LOAD 



/RMX/DEIOS/EPIFC.LIB, 

/RMX/DBIOS/IPIFC.LIB, 

/RMX/DNUCLUS/RPIFC.LIB 

TO /RMX/DLOADER/LOADER.LNK 

PRI NT (/RMX/D LOADER/LOADER . MP1 ) 




'CONFIGURATION- PARAMETER 2 
A - ABSOLUTE 
P - ABSOLUTE + PIC 
L - ABSOLUTE + PIC + LTL 
- ABSOLUTE + PIC + LTL WITH 
OVERLAYS 

"CONFIGURATION PARAMETER 3 
N - NO LOAD- JOB FUNCTION 
A - ASYNCHRONOUS LOAD-JOB FUNCTION 
S - ASYNCHRONOUS + SYNCHRONOUS LOAD- 
JOB FUNCTION 



L0C86 



NOPUBLICS EXCEPT(RQLOADERINITTASK, RQLOADERINITERROR) 

/RMX/DLOADER/LOADER.LNK TO /RMX/DLOADER/LOADER & 
MAP PR I NT (/RMX/D LOADER/LOADER. MP2) & 
NOLINES NOCOMMENTS NOSYMBOLS & 
ORDER (CLASSES (CODE, DATA)) & 
SEGSIZE(STACK(0), DATA(2)) & 



ADDRESSES(CLASSES(C0DEC%1) )J 



LOCATE ADDRESS 
•SUBMIT /RMX/DLOADER/LOADER (DATE, LOC.ADR, CP2, CP3) 



V 
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LOCATE ADDRESSES 



• THE L0C86 PROGRAM GENERATES A MAP FILE CALLED 
/RMX/DLOADER/LOADER . MAP 



EXAMINING THE MAP WE OBTAIN THE ENDING ADDRESS OF THE LOADER 
(USED FOR LOCATING THE NEXT JOB) 



MEMORY 


MAP OF MODULE LDRINT 






SEGMENT MAP 










START 


STOP 


LENGTH ALIGN 


NAME 


CLASS 


00200H 


00216H 


0017H 


A 


(ABSOLUTE) 




1D150H 


1F432H 


22E3H 


W 


CODE 


CODE 


1FM0H 


1F441H 


0002H 


G 


DATA 


DATA 


1F450H 


1F450H 


0000H 


G 


??SEG 




1F450H 


1F450H 


0000H 


W 


STACK 


STACK 


(TF450E> 


1F450H 


0000H 


W 


MEMORY 


MEMORY 
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DON'T FORGET ROOT JOB MACRO! 

ADD A %JOB MACRO TO YOUR SYSTEM ROOT JOB 
• MUST BE BETWEEN IOS AND EIOS %JOB MACROS 




;APP LOADER 




%JOB(0, 


5 'OBJECT DIRECTORY SIZE 


20H,20H, 


%'POOL SIZE (MIN, MAX) 


50,5, 


%'MAX OBJECTS AND TASKS 


0, 


%'MAX JOB PRIORITY 


0:0,0, 


%' EXCEPT I ON HANDLER, MODE 


0, 


%'JOB FLAGS 


130, 


%'INIT TASK PRIORITY 


1d15:0, 


%'INIT TASK ENTRY 


0, 


%'INIT TASK DATA SEGMENT ADDRESS 


0,160, 


%'INIT TASK STACKADDRESS, STACKSIZE 


0) 


%'INIT TASK FLAGS 



V 
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ICU86 



ICU86 WILL 



V 



- CREATE LC0NFG.P86 

- CREATE A SUBMIT FILE THAT INCLUDES COMPILING 
LINKING AND LOCATING OF THE APP LOADER 

- ADD A JOB MACRO TO THE ROOT JOB 

- COMPUTE THE STARTING ADDRESS OF THE LOADER 
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******* LAB SIX (APP LOADER SYSTEM) ******* 



)BJECTIVES: 



EXECUTE A STUDENT APP LOADER APPLICATION JOB IN AN RMX86 O.S. ENVIROMENT 

INTRODUCE (EIOS) SYSTEM CALLS: 

- RQ$S$LOAD$IO$JOB 

USE ICU TO BUILD A SYSTEM CONTAINING: 

- A NUCLEUS 

- A BIOS 

- AN EIOS 

- AN APPLICATION LOADER 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED START. P86 

- A SOURCE FILE NAMED LDRLAB.P86 

COMPILE (PLM86), LINK, AND LOCATE AN APPLICATION JOB, THAT WILL CALL UPON 
THE EIOS TO COMMUNICATE WITH A FILE IN A FLOPPY, CONTAINING A LOADABLE 
JOB, LOAD THE JOB AN EXECUTE 



THE LOADABLE JOB WILL CONTAIN A SIMPLE TASK THAT FLASHES THE LIGHTS IN 
THE LIGHT BOX 



ITEP1 : 



USE THE ATTACH$FILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAMEVLAB6) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAME"/LAB6 AS :LAB: 
* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 

LAB 6 (PART A) 




LI6KTB0X 



• LAB OBJECTIVE 

• USE THE APPLICATION LOADER TO LOAD A MAIN MODULE (JOB), SYNCHRONOUSLY USING THE EIOS 

• THE STUDENT WILL BE GIVEN THE NUCLEUS, ElOS, "BlOS, SOB 

• THE STUDENT HILL SUPPLY APPLICATION, ROOT, LOADER AND WILL BUILD AND PLACE FLASH JOB 
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******* LAB SIX (APP LOADER SYSTEM) ******* 
STEP2: 

BUILD A SYSTEM CONTAINING THE APPLICATION LOADER 

* WE WILL USE THE SYNCHRONOUS LOADER CALL TO LOAD AN 10 JOB FROM 
A FLOPPY INTO MEMORY 

* SINCE THIS REQUIRES THAT OUR SYSTEM INCLUDE THE EXTENDED 10, WE 
WILL USE THE SYSTEM WE ALREADY BUILT IN LAB FIVE. 

THE (ICU) IS- INVOKED BY TYPING THE FOLLOWING 
-ICU86 /R I I 5 . 0/LAB5 / I CU . DEF TO :LAB:ICU.DEF 

* WHERE ICU. DEF IS THE NAME OF THE FILE WE HAVE CHOSEN TO CONTAIN 
THE INFORMATION NEEDED TO CONFIGURE OUR O.S. 

WHEN THE ICU SIGN ON ENTER THE COMMAND C , TO MODIFY THE SCREENS 
APP LOADER SCREENS: 

Application Loader 

TIBS) Internal Buffer Size (0 - OFFFFh) 0400H 

(RBS) Read Buffer Size (0 - OFFFFh) 0400H 

(LJT) Load Job Type ( None/As vnc/Sync) Synchronous and Asyncronous 

(DMP) Default Memory Pool Size (0 - OFFFFh) 0100H 

(CT) Code Type (Abs/Pic/Ltl/Ovr) Overlay, LTL, PIC and Abs 

(ALR) Application Loader in ROM (Yes/No) No 



STEP3: 

AFTER YOU ENTER ALL OF THE SCREENS ENTER G TO GENERATE 
EXIT THE ICU 

SUBMIT THE ICU.CSD FILE TO GENERATE YOUR SYSTEM 
-SUBMIT :LAB: ICU.CSD 
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******* LAB SIX (APP LOADER SYSTEM) ******* 

STEP4: 

BUILD THE RESIDENT JOB 

MODIFY A SOURCE FILE TPARTIALLY SUPPLIED FOR YOU) NAMED :LAB:LDRLAB.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:LDRLAB.P86 

* THIS SOURCE FILE IS THE APPLICATION TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 

CREATE A RESPONSE MAILBOX 

LOAD THE JOB FROM :FDO:FLASHJOB 

CREATE FILE CONNECTION TO TERMINAL */* (9(4,' :TO:') 

OPEN TERMINAL FILE */* (R/W) , SHARE ALL , *NOTE 

WRITE MESSAGE TO TERMINAL */* MESSAGE = "FILE HAS BEEN LOADED 

CLOSE TERMINAL FILE */* 

** DELETE SELF ** CALL EXIT$IO$JOB 
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******* LAB SIX (APP LOADER SYSTEM) ******* 
STEP5: 

* ROOT JOBS ABSOLUTELY ADDRESS THE STARTING LOCATION OF THE STUDENT'S 
JOB CODE. THE ENTRY POINT MAY VARY IF INTERNAL PROCEDURES OR 
CHARACTER CONSTANTS ARE USED. 

FOR THIS REASON IT IS ADVISABLE TO CREATE AND LINK A START TASK TO 
THE REST OF THE APPLICATION CODE TO FIX THE ENTRY POINT'S OFFSET 
INTO THE CODE 

* THIS APPLICATION JOB WILL BE A SECOND LEVEL JOB. A TASK WITHIN THIS 
JOB IS NOT REQUIRED TO MAKE A CALL TO RQ$END$INIT$TASK, THE EIOS CODE 
SUPPLIES A TASK THAT CALLS RQ$END$INIT$TASK 

* IN ORDER TO DEBUG OUR CODE BEFORE IT "CRASHES" WE MAY WISH TO 
INVOKE THE 957 MONITOR AT THE START OF OUR JOB'S EXECUTION. 

THIS CAN EASILY BE ACCOMPLISHED BY PLACING A "CAUSE$INTERRUPT(3) H 
INSTRUCTION AT THE BEGINNING OF OUR CODE (IN OUR START TASK). 

* WE WILL USE THE SAME START TASK THAT WE USED IN LAB TWO 

-COPY /RII5.0/LAB2/START.P86 TO : LAB: START. P86 
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******* l AB six (APP LOADER SYSTEM) ******* 
STEP6: 

COMPILE THE SOURCE FILES (START. P86 AND LDRLAB.P86) 

- PLM86 : LAB: START. P86 

- PLM86 :LAB:LDRLAB.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE FOR EACH OF 
THE SOURCE FILES: 

- A LIST FILE NAMED ":LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED ":LAB: (SOURCE) .OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 :LAB:START.OBJ,& 
:LAB:LDRLAB.OBJ,& 
/RMX5.0/DUTILS/EPIFL.LIB,& 
/RMX5.0/DUTILS/IPIFL.LIB,& 
/RMX5.0/DUTILS/LPIFL.LIB,& 
/RMX5.0/DUTILS/RPIFL.LIB & 

TO :LAB:JOB.LNK & 
NOMAP 

LOCATE THE LINKED MODULE TO AN ABSOLUTE ADDRESS 

L0C86 :LAB:JOB.LNK & 

TO :LAB:LABJOB & 
SC(3) SEGSIZE(STACK(0)) & 
ORDER (CLASSES (CODE, DATA, STACK)) & 
ADDRESSES(CLASSES(C0DE(1040H))) & 
NOINITCODE & 
OC(PURGE) 



YOU MUST NOW ADD THE USER JOB AND THE SDB TO THE SYSTEM, 
USING THE LIB86 UTILITY 

-LIB86 

DELETE : LAB : RMX86 ( STARTMOD ) 

ADD : LAB: LAB JOB to :LAB:RMX86 

DELETE :LAB:RMX86(INT3TASKM0D) 

ADD /DINT3/INT3JOB to :LAB:RMX86 
EXIT 



* THE STUDENT MAY "OPTIONALLY" USE A "GIVEN" SUBMIT FILE THAT WILL 
COMPILE , LINK , LOCATE AND ADD THE FINAL MODULE TO THE SYSTEM 

- SUBMIT :LAB:JOB.CSD 
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******* LAB SIX (APP LOADER SYSTEM) ******* 
STEP6: 

BUILD THE NON RESIDENT JOB ' 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB:FLASHJ0B.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:FLASHJ0B.P86 

* THIS SOURCE FILE IS THE NON RESIDENT TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 



DO FOREVER 


OUTPUT OFFH 


TO 


PORT 


09CH 


GO TO SLEEP 


FOR 


1 1/4 SEC 


OUTPUT 


TO 


PORT 


09CH 


GOT TO SLEEF 


> FOR 1/4 SEC 



STEP7: 

COMPILE THE SOURCE FILES (FLASHJ0B.P86) 
- PLM86 :LAB:FLASHJ0B.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE 

- A LIST FILE NAMED ": LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED ":LAB: (SOURCE). OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 : LAB: FLASH JOB. OB J, & 

/RMX5.0/DUTILS/RPIFL.LIB & 

TO : LAB: FLASH JOB & 
NOMAP SEGSIZE(STACK(512)) BIND 

COPY THE JOB INTO A FILE ON THE FLOPPY 

COPY :LAB:FLASHJOB OVER :FDO:FLASHJOB 
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******* LAB SIX (APP LOADER SYSTEM) ******* 



STEP8: 



* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /"TEAM NAME"/LAB6/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 
( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

.* GOOD LUCK...! 
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CHAPTER 12 
fMMX 800 

Multi Message exchange Software 

• BASIC CONCEPTS 
t CHANNELS 

• MMX SYSTEM CALLS 

• THE MMX JOB 



iMMX 800 

MESSAGE TRANSFER 

MESSAGE SENDING AND RECEIVING MODEL 



SENDING TASK 



RECEIVING TASK 



TASK ENTRY POINT 

INITIALIZE TASK 

PERFORM FUNCTION 

SEND MESSAGE - 

WAIT FOR RESPONSE^IIZi: 



:tion ^^S 



TASK ENTRY POINT 
INITIALIZE TASK 
WAIT FOR. MESSAGE 
PERFORM FUNCTION 
SEND RESPONSE 



RMX SOFTWARE IMPLEMENTS THIS MODEL OF INTER TASK COMMUNICATION 
BETWEEN TASKS RESIDING ON THE SAME DEVICE (BOARD). 

iMMX SOFTWARE GENERALIZES THE MODEL TO ACCOMODATE INTERDEVICE 
COMMUNICATION. 
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BASIC CONCEPTS 

• DEVICE - A PROCESSOR BOARD IN A SYSTEM 

PORT - A LOGICAL DELIVERY MECHANISM WHICH UTILIZED FIFO 
ORDER (QUEUE) 



("device 



c 



~ I rOEVICE 1 
II 



TASK TASK | | TASK 



i—* - ! r*i p o RT 1 1 P0BT f"^ r*H \~\ 

Ep Ef 3 - ii ' *¥ Ep *¥ 



} 



r 


MIP facility 






1 1 PORT 


1 




TASK 

E 






L 


DEVICE 2 
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DATA BASE APPLICATION EXAMPLE 



"\ 



V 



t 2 OPERATORS - 2 TERMINALS ACCESSING DATA FILES 

• THE TERMINALS CONTROLLED BY RMX 80 

• THE DATA BASE ("WINCHESTER") CONTROLLED BY RMX 86 BASIC I/O SYSTEM 



(8085) 
RMX 80 
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CHANNELS 

• COMMUNICATION BETWEEN DEVICES IS IMPLEMENTED USING CHANNELS 

- A CHANNEL CONSISTS OF A PAIR OF QUEUES 

- ONE CHANNEL MUST BE DEFINED FOR EACH DEVICE PAIR 
WHICH WILL COMMUNICATE WITH EACH OTHER 



Raqunt Oimit 




8 byte* 



Request Queue 
Descriptor 



ROD | 



RQE 



RQE 



Request Queue ) I 
.Entries \ I 



RQE 



RQE 



16 bytes 
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CHANNELS 

• A CHANNEL MUST RESIDE IN A MEMORY SEGMENT ACCESSIBLE 
BY BOTH DEVICES WHICH USE THAT CHANNEL 

- GLOBAL MEMORY 

- DUAL PORT MEMORY 







V 
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MESSAGE TRANSFER (FULL DELIVER) 
• 1) MESSAGE IS COPIED ON SEND 
2) MESSAGE IS COPIED ON RECEIVE 



corv 




OENEMC MESSAGE 



>' 



WITT 



s OCNEMC MESSAGE 



MMX" M MOMENT 



V 
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iMMX 800 
MESSAGE TRANSFER 



>v 



IP61II 



<»W OCIiMCt 



MESSAGE 

TEXT 



IMMX 800 MESSAGE MANAGERS 



> 



KSSME 

TEH 



■MSmiCSMK 

• HEADERS ARE NOT PASSED BETWEEN DEVICES 

t MEMORY SEGMENTS FOR MESSAGES ARE ALLOCATED BY 

- iRMX 86 NUCLEUS 

- iRMX 80/88 FREE SPACE MANAGER (PMM) 
t TWO TRANSMISSION MODES ARE AVAILABLE 

- TRANSPARENT 

•MESSAGE RESIDES IN NON-SHARED MEMORY 
•MESSAGE IS COPIED PRIOR TO TRANSMISSION 
•COPIED ALSO AT RECEIPT 

- NON-TRANSPARENT 

•MESSAGE IS ACCESSIBLE BY BOTH DEVICES 
•COPY ONLY ON RECEIPT 
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SUPPORTED SINGLE BOARD COMPUTERS 



iRMX 80 


IRMX 88 


iRMX 86 


OPERATING 


OPERATING 


OPERATING 


SYSTEM 


SYSTEM 


SYSTEM 


ISBC 80/24 


iSBC 86/05 


iSBC 86/05 


I SBC 80/30 


ISBC 86/12A 


I SBC 86/12A 


I SBC 544 


I SBC 86/14 


ISBC 86/14 


ISBC 569 


ISBC 86/30 


I SBC 86/30 




I SBC 88/25 


I SBC 88/25 




ISBC 88/40 


I SBC 88/40 




ISBC 88/45 


I SBC 88/45 
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iMMX 800 



• COMES IN THREE VERSIONS 

- OPERATION UNDER iRMX 80 NUCLEUS 

*tMMX 800/80 

- OPERATION UNDER iRMX 88 NUCLEUS 

*iMMX 800/880 FOR NON-MEGABYTE SUPPORT 
•iMMX 800/881 FOR MEGABYTE SUPPORT 

-OPERATION UNDER iRMX 86 NUCLEUS 
•iMMX 800/86 

t ALL THREE VERSIONS PRESENT IDENTICAL USER INTERFACES 



V 
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SOFTWARE MEMORY REQUIREMENTS 



V. 



EXECUTIVE 


K BYTES 


iRMX 80 OPERATING SYSTEM 

iRMX 88 OPERATING SYSTEM 
128K SUPPORT 
1MB SUPPORT 

"COMPACT" 
"LARGE" 

iRMX 86 OPERATING SYSTEM 


3.7K BYTES 

4.8K BYTES 

5.5K BYTES 
6.3K BYTES 

6.6K BYTES 
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APPLICATION EXAMPLE 

WHEN AN OPERATOR ENTERS A REQUEST AT A TERMINAL, THE FOLLOWING 
SEQUENCE OCCURS: 

1. A TASK ON THE ISBC 80/24 BOARD IN THE TERMINAL BUILDS A MESSAGE 
THAT MEETS iRMX 80 MESSAGE-FORMAT REQUIREMENTS AND ISSUES A 
CQXFER CALL TO MMX 80. (CQXFER IS THE NAME OF THE iMMX 80 
TRANSFER PROCEDURE) . 

2. MMX 80 TRANSFERS THE MESSAGE TO MMX 85 ON THE iSBC 86/12A BOARD. 

3. MMX 86 REFORMATS THE MESSAGE AND PASSES IT TO AN iRMX 86 TASK. 

4. THE I/O SYSTEM PERFORMS THE NECESSARY I/O OPERATIONS FOR THE TASK. 

5. THE TASK PUTS THE DATA IN A MESSAGE THAT SATISFIES RMX 86 FORMAT 
CONVENTIONS AND ISSUES A CQXFER CALL TO MMX 86. 

6. MMX 86 TRANSFERS THE MESSAGE TO MMX 80 ON THE iSBC 80/24 BOARD. 

7. MMX 80 REFORMATS THE MESSAGE TO MEET I RMX 80 FORMAT REQUIREMENTS 
AND PASSES IT TO THE iRMX 80 TASK. 

8. THE TASK EXTRACTS THE DATA FROM THE MESSAGE AND SENDS IT TO 
THE TERMINAL. g> g 



"N 










Jf 



a 
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i MMX SYSTEM CALLS 



FUNCTION 


NAME 


DESCRIPTION 


FIND PORT 


CQFIND 


FIND A PORT AND RETURN A CONNECTION-ID. 


ACTIVATE PORT 


CQACTV 


ACTIVATE A PORT FOR RECEIVING MESSAGES FROM 
OTHER TASKS. 


TRANSFER MESSAGE 


CQXFER 


TRANSFER A MESSAGE TO A PORT IDENTIFIED BY 
THE CONNECTION-ID. 


DEACTIVATE PORT 


CQDACT 


DEACTIVATE PORT. FURTHER MESSAGES ARE 
RETURNED TO THE SENDER. 


LOSE 


CQLOSE 


LOSES A CONNECTION TO A PORT. 



V 
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WHAT IS MIP? 



"N 



V. 



THE MULTIBUS INTERPROCESSOR PROTOCOL (MIP) IS A SPECIFICATION 
FOR A SET OF MECHANISMS AND PROTOCOLS. 

• PROVIDES AN EXCHANGE OF DATA AMONG TASKS EXECUTING ON VARIOUS 
SINGLE-BOARD COMPUTERS. 



Non-MIP Otvtcc 



Noo-MIP D«vici 
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MESSAGE MANAGER 
• FUNCTIONALITY FROM USER VIEWPOINT 



V 



PRODUCER 



i~ 



FIND A 
CONNECTION 



TRANSFER 
A MESSAGE 



CLOSE THE 
CONNECTION 



CONSUMER 



U 



ACTIVATE 
SYSTEM PORT 
ii 



RECEIVE 

THE 
MESSAGE 



Ub-ACIIVAIfc 
SYSTEM PORT 
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THREE- LEVEL INTERFACE STRUCTURE 



V 



THE VIRTUAL LEVEL, BY WHICH USER TASKS INTERACT WITH THE HIP FACILITY. 

THE PHYSICAL LEVEL, BY WHICH THE MP FACILITIES ON DIFFERENT DEVICES 
INTERACT WITH EACH OTHER. 

THE LOGICAL LEVEL, WHICH TRANSLATES BETWEEN THE VIRTUAL LEVEL AND 
THE PHYSICAL LEVEL. 

VIRTUAL LEVEL 







Interface 
Procedures 


1 

3 


Receiving 


ACTIVATE 


RECEIVE 


DEACTIVATE 


Sending 


FIND 


TRANSFER 
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SIGNALING 

• I MUX SOFTWARE SUPPORTS FOUR DIFFERENT SIGNALING MECHANISMS: 

- MULTIBUS INTERRUPTS 

- MEMORY MAPPED INTERRUPTS 

- IO-PORT MAPPED INTERRUPTS 

- POLLING 

t A SOFTWARE HANDSHAKE THAT USES FLAGS IS ALSO EMPLOYED FOR 
MORE EFFICIENT THROUGH PUT. 

- e.g. A QUEUE KNOWN TO BE EMPTY IS NOT EXAMINED BY INSTASK. 
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THE USER APP JOB AND MMX 800/86 



"\ 



• A USER JOB MUST LINK TO A SET OF INTERFACE PROCEDURES 

• THESE PROCEDURES ARE IN A LIB NAMED R4LINF.LIB OR R4CINF.LIB 



USER APP 1 



R4XINF.LIB 
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I MMX 800 IN AN RMX86 ENVIRONMENT 




• MMX SOFTWARE IS A JOB IN THE SYSTEM 

• THERE IS AN MMX JOB IN EACH SYSTEM OF EACH DEVICE 



12-18 



r 



v 



STEPS IN BUILDING THE MMX JOB 

1. BUILD A CONFIGURATION FILE NAMED 'RACNFG.P86. 

2. COMPILE AND PRODUCE AN OBJECT MODULE. 

3. LINK THE MODULE TO A SET OF MMX LIBS. 

4. LOCATE THE LINKED MODULE TO AN ABSOLUTE ADDRESS. 

5. ENTER A "USER JOB" IN ICU86 FOR THE MMX JOB. 



V 
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THE CONFIGURATION MODULE (R4CNFG.P86) • 

• THE CONFIGURATION MODULE IS A SET OF STRUCTURES. 

• THESE STRUCTURES CONTAIN INFORMATION ABOUT THE CONFIGURATION 
AND REQUIREMENTS OF YOUR SYSTEM. 

• THESE STRUCTURES FALL INTO THREE CATEGORIES: 

- SYSTEM LEVEL DECISIONS 

- DEVICE LEVEL DECISIONS 

- PORT LEVEL DECISIONS 
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EXERCISE 

f THE CONFIGURATION CHAPTER IN THE LMMX800 REFERENCE 
MANUAL DESCRIBES EACH OF THE STRUCTURES IN DETAIL. 

• WITH THE AID OF YOUR INSTRUCTOR FILL IN THE BLANKS 
TO ACCOMODATE THE TWO RMX86 DEVICE EXAMPLE. 
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FFFFH 



OH 



A 



AN EXAMPLE CONFIGURATION FOR TWO RMX86 DEVICES 
• MEMORY MAP FOR OUR EXAMPLE: 

SBC 064 



(DEVICE 0) 


10000H 


SHARED 
MEMORY 


FFFFH 
OH 


(DEVICE 1) 






MEM POOL 


^PRIVATE 


MEM POOL 


ROOT JOB 


ROOT JOB 


MMX JOB 


MMX JOB 


APP JOB 


APP JOB 


NUCLEUS 


NUCLEUS 


VECTOR TABLE 


VECTOR TABLE 


SBC 86/12A 


SBC 86/12A 



►PRIVATE 



V 
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EXAMPLE CONFIGURATION FOR TWO RMX86 DEVICES 



t SEND/RECEIVE ARCHITECTURE 



Q »■ REQUEST QUEUE 
X » iMMX PORT 





RMX 86 




•M- 
M 
X 


O i 


*M- 
M 
X 




RMX 86 






PRODUCER 




*•> 


CONSUMER 






r O 
















CONSUMER 


< Y 




PRODUCER 




"■ A 




1 u 



















V 
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EXERCISE (CONTINUED) 
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DECLARE CQDVCS BYTE PUBLIC 
DATA ( )j 

DECLARE CQSKTS BYTE PUBLIC 
DATA ( )i 

DECLARE CQPRTS BYTE PUBLIC 
DATA ( ); 

DECLARE CQMDLY WORD PUBLIC 
DATA ( ); 

DECLARE CQITWT WORD PUBLIC 
DATA ( ); 
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EXERCISE (CONTINUED) 



DECLARE DSDT ( 
PUBLIC 
DATA ( 

j 
j 
j 
j 


) DSD$ENTRY$TYPE 


): 




DECLARE LPT$ROM ( 
PUBLIC 
DATA ( )i 

DECLARE LPT$RAM ( 
PUBLIC; 


) LPT$ROM$ENT 
) LPT$RAM$ENT 
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EXERCISE (CONTINUED) 



DECLARE DCM$ROM (. 
PUBLIC 
DATA ( , 



) DM$ROM$ENTRY$TYPE 



)j 

DECLARE DCM$RAM (. 
PUBLIC; 



) DM$RAM$ENTRY$TYPE 



DECLARE CQSGLY WORD PUBLIC 
DATA ( ); 

DECLARE CQIDPD WORD PUBLIC 
DATA ( ); 
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EXERCISE (CONTINUED) 


DECLARE SF ( 


) SFT$ENTRY$TYPE 


PUBLIC 




DATA ( 

,,. j 




00CEH, 




0003H 




00H, 




0000H, 




0000H, 




000H, 




0000H, 




0000H); 




DECLARE CQIDSS BYTE 


PUBLIC 


DATA ( ); 




DECLARE IDST ( 


) IDS$ENTRY$TYPE 


PUBLIC 




DATA ( )j 
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EXERCISE (CONTINUED) 



DECLARE CQPLHS BYTE 


PUBLIC 


DATA ( ); 




DECLARE PLHTBL ( 


) POOL$ENTRY$T 


DECLARE CQBLKS BYTE 


PUBLIC 


DATA ( ); 




DECLARE BLKTBL 


BLOCK$ENTRY$TYPE 


PUBLIC 




DATA ( 

.... -.. -» 




). 
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******* LAB SEV en f MMX800/86 SYSTEM) PART A ******* 



OBJECTIVES: 



EXECUTE A STUDENT MMX800/86 APPLICATION JOB IN AN RMX86 O.S. ENVIROMENT 

INTRODUCE (MMX800/86) SYSTEM CALLS: 

- CQ$ACTV 

- CQ$FIND 

- CQ$XFER 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED START. P86 

- A SOURCE FILE NAMED MMXLAB.P86 

COMPILE (PLM86), LINK, AND LOCATE AN APPLICATION JOB, THAT WILL CALL UPON 
THE MMX800/86 TO COMMUNICATE WITH AN EXTERNAL DEVICE 
(THE TRUTH IS THAT WE WILL ONLY USE ONE DEVICE , AND THAT DEVICE WILL 
COMMUNICATE WITH ITSELF...) 



STEP1: 



USE THE ATTACH$FILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME"/LAB7) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAME"/LAB7 AS :LAB: 
* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 




Light Box 



• USE MMX 800/86 SYSTEM CALLS 

• COMMUNICATION TO A LIGHT BOX 

t SIMULATE INTERDEVICE COMMUNICATION 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART A ******* 

STEP2: 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB:MMXLAB.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:N!MXLAB.P86 

* THIS SOURCE FILE IS THE APPLICATION TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 



ACTIVATE 


THE PODUCER 


PORT 












FIND THE 


CONSUMER CONNECTION 












DO FOREVER 




CREATE A 


SEGMENT 














1ST BYTE 


IN SEGMENT = 


READ 


SWITCHES 


PORT 9CH 




2ND BYTE 


IN SEGMENT = 


READ 


SWITCHES 


PORT 9DH 




TRANSFER 


MESSAGE 


(SEGMENT) 


TO 


OTHER 


DEVICE 




WAIT AND 


RECEIVE 


MESSAGE f SEGMENT) f 


r ROM OTHER DEVICE 




LIGTHS PORT 9CH = 


= 1ST 


BYTE 


IN 


MESSAGE RECEIVED 




LIGTHS PORT 9DH = 


•■ 2ND 


BYTE 


IN 


MESSAGE RECEIVED 


* DELETE SELF ** 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART A ******* 



STEP3: 



* ROOT JOBS ABSOLUTELY ADDRESS THE STARTING LOCATION OF THE STUDENT'S 
JOB CODE. THE ENTRY POINT MAY VARY IF INTERNAL PROCEDURES OR 
CHARACTER CONSTANTS ARE USED. 

FOR THIS REASON IT IS ADVISABLE TO CREATE AND LINK A START TASK TO 
THE REST OF THE APPLICATION CODE TO FIX THE ENTRY POINT'S OFFSET 
INTO THE CODE 

* THIS APPLICATION JOB WILL BE A FIRST LEVEL JOB, THIS REQUIRES 
THAT A TASK WITHIN THIS JOB MAKE A CALL TO RQ$END$INIT$TASK 
TO RESUME THE ROOT TASK 

* 'IN ORDER TO DEBUG OUR CODE BEFORE IT "CRASHES" WE MAY WISH TO 

INVOKE THE 957 MONITOR AT THE START OF OUR JOB'S EXECUTION. 

THIS CAN EASILY BE ACCOMPLISHED BY PLACING A "CAUSE$INTERRUPT(3)" 

INSTRUCTION AT THE BEGINNING OF OUR CODE fIN OUR START TASK). 

* WE WILL USE THE SAME START TASK THAT WE USED IN LAB TWO 

-COPY /RII5.0/LAB2/START.P86 TO :LAB: START. P86 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART A ******* 
STEP4: 

COMPILE THE SOURCE FILES (START. P86 AND MMXLAB.P86) 

- PLM86 : LAB: START. P86 

- PLM86 :LAB:MMXLAB.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE FOR EACH OF 
THE SOURCE FILES: 

- A LIST FILE NAMED ":LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED ":LAB: (SOURCE) .OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 : LAB : /START. OB J, % 
:LAB:/MMXLAB.OBJ,K< 
/MMX86/R4LINF.LIB,& 
/RMX5.0/DUTILS/EPIFL.LIB,& 
/RMX5.0/DUTILS/IPIFL.LIB,& 
/RMX5.0/DUTILS/RPIFL.LIB & 

TO :LAB:/JOB.LNK & 
NOMAP 

LOCATE THE LINKED MODULE TO AN ABSOLUTE ADDRESS 

L0C86 :LAB:/JOB.LNK & 

TO :LAB:/LABJOB & 
SC(3) SEGSIZE(STACK(0)) & 
ORDER ( CLASSES ( CODE , DATA , STACK ) ) & 
ADDRESSES ( CLASSES ( CODE ( 1040H ) ) ) & 
NOINITCODE & 
OC( PURGE) 

AND FINALLY ADD THE LOCATED MODULE TO THE OTHER PRECONFIGURED 
PARTS OF OUR SYSTEM 

LIB86 

DELETE :LAB:RMX86(STARTMOD) 

ADD :LAB:LABJOB to :LAB:RMX86 

EXIT 

* :LAB:RMX86 IS A "GIVEN" FILE THAT CONTAINS: 

- A PRECONFIGURED NUCLEUS 

- A PRECONFIGURED MMX800/86 

- A PRECONFIGURED ROOT JOB 
= A PRECONFIGURED SDB 

* THE STUDENT MAY "OPTIONALLY" USE A "GIVEN" SUBMIT FILE THAT WILL 
COMPILE , LINK , LOCATE AND ADD THE FINAL MODULE TO THE SYSTEM 

- SUBMIT :LAB:JOB.CSD 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART A ******* 
>TEP5: 

* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /"TEAM NAME"/LAB7/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 
( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART B ******* 

OBJECTIVES: 

EXECUTE A STUDENT MMX800/86 APPLICATION JOB IN AN RMX86 O.S. ENVIROMENT 

LEARN HOW TO BUILD A CONFIGURATION FILE , AND AN MMX86 JOB TO REPLACE THE 
ONE GIVEN IN THE PREVIOS LAB (LAB SEVEN PART A) 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED R4CNFG.P86 



STEP1: 



USE THE ATTACH$FILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME"/LAB7) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAME"/LAB7 AS :LAB: 

* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 



STEP2: 



MODIFY A SOURCE FILE fPARTIALLY SUPPLIED FOR YOU) NAMED :LAB:R4CNFG.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:R4CNFG.P86 
* THIS SOURCE FILE IS THE MMX86 CONFIGURATION FILE 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART B ******* 
5TEP3: 

COMPILE THE SOURCE FILE (R4CNFG.P86) 
- PLM86 :LAB:R4CNFG.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* ELSE THE FOLLOWING FILES WILL BE CREATED 

- A LIST FILE NAMED ":LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED ": LAB: (SOURCE) .OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 /MMX86/R4DRVR.LIB(MBEGIN) ,& 
:LAB:R4CNFG.0BJ,& 
/MMX86/R4DRVR.LIB ,& 
/MMX86/R4XMGR.LIB ,& 
/MMX86/R4957P.LIB ,& 
/MMX86/R4PMM.LIB ,& 
/MMX86/R4UTIL.LIB ,ft 
/RMX5.0/DUTILS/RPIFC.LIB & 

TO :LAB:JOB.LNK & 
NOMAP NOTYPE 

LOCATE THE LINKED MODULE TO AN ABSOLUTE ADDRESS 

L0C86 :LAB:JOB.LNK & 

TO :LAB:MMXJOB & 
SCO) SEGSIZE(STACK(0)) & 
ORDER ( CLASSES ( CODE , DATA , STACK ) ) & 
ADDRESSES(CLASSES(CODE(3000H)")) & 
NOINITCODE & 
OC(PURGE) 

AND FINALLY ADD THE LOCATED MODULE TO THE OTHER ^RECONFIGURED 
PARTS OF OUR SYSTEM 

.IB86 

DELETE :LAB:RMX86(MBEGIN) - 

\DD :LAB:MMXJOB to :LAB:RMX86 

EXIT 



* THE STUDENT MAY "OPTIONALLY" USE A "GIVEN" SUBMIT FILE THAT WILL 
COMPILE , LINK , LOCATE AND ADD THE FINAL MODULE TO THE SYSTEM 

- SUBMIT :LAB:MMXJOB.CSD 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART B ******* 

STEP5: 

* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /"TEAM NAME"/LAB7/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 
( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
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CHAPTER 13 
HUMAN INTERFACE 

t COMMANDS 

• SYSTEM CALLS 

• THE RESIDENT USER 

• DEFINITION FILES 



r 



HUMAN INTERFACE COMMANDS 



RMX BOX 



PERIPHERAL 
/ 7 


\>^ MEMORY / 






RMX 
O.S. 












V. 



• COMMANDS ARE PROGRAMS (COPY, RENAME ETC. ) 

• THESE PROGRAMS ARE JOBS CREATED BY THE H.I. 

LOADED BY THE HUMAN INTERFACE UPON OPERATOR'S REQUEST. 



r 



v. 
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INTEL PROVIDES A SET OF COMMANDS 



ATTACHDEVICE 


DIR 


JOB DELETE 


ATTACHFILE 


DISKVERIFY 


LOCK 


BACKUP 


DOWNCOPY 


PERMIT 


COPY 


FORMAT 


RENAME 


CREATED I R 


INITSTATUS 


RESTORE 


DATE 




SUBMIT 


DEBUG 




SUPER 


DELETE 




TIME 


DETACHDEVICE 




UPCOPY 


DETACHFILE 




VERSION 



~\ 



• A COMPLETE DESCRIPTION OF THESE COMMANDS ARE FOUND IN THE 
iRMX 86 OPERATOR'S MANUAL. 
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SYSTEM CALLS 



t A SET OF CALLS ARE AVAILABLE TO AID IN THE CREATION OF CUSTOM 
COMMANDS. 

C$GET$INPUT$CONNECTION C$GET$COMMAND$NAME 

C$GET$OUTPUT$CONNECTION C$FORMAT$EXCEPTION 

C$6ET$CHAR C$SEND$CO$RESPONSE 

C$GET$INPUT$PATHNAME C$SEND$EO$RESPONSE' 

C$GET$PARAMETER C$CREATE$COMMAND$CONNECTION 

C$GET$OUTPUT$PATHNAME C$DELETE$COMMAND$CONNECTION 

C$SET$PARSE$BUFFER C$SEND$COMMAND 

t A COMPLETE DESCRIPTION OF THESE H.I. SYSTEM CALLS ARE FOUND IN 
THE 1RMX86 HUMAN INTERFACE REFERENCE MANUAL. 
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HUMAN INTERFACE INITIAL PROGRAM 

• INTEL PROVIDES THE DEFAULT RESIDENT INITIAL PROGRAM, 
t THIS PROGRAM IS A STANDARD COMMAND LINE INTERPRETER. 

• YOU MAY PROVIDE YOUR OWN INITIAL PROGRAM DURING CONFIGURATION. 
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\ 

THE RESIDENT USER 



t THE RESIDENT USER MAY BE: 

-THE ONLY USER IN THE SYSTEM 

-THE FIRST USER IN A MULT I -ACCESS SYSTEM 

• RESIDENT USER IS DEFINED DURING CONFIGURATION BY: 

-TERMINAL DEVICE NAME 
-MAX TASK PRIORITY 
-USER ID 

-INITIAL PROGRAM 
-DEFAULT PREFIX 
-POOL SIZE 



r 
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MULTI -ACCESS USER DEFINITION 

• OTHER USERS ARE DEFINDED IN FILES THAT DESCRIBE THE 
OPERATOR AND HIS TERMINAL . 

• THE PATHNAMES FOR THESE FILES ARE: 

CONFIG/TERMINALS (TERMINAL DEFINITION FILE) 
CONFIG/USER/ID# (USER DEFINITION FILE) 

• ID# IS THE ACTUAL ID NUMBER FOR THAT PARTICULAR USER 

-E.G. CONFIG/USER/0082 

t IF THESE FILES DO NOT EXIST, THE HUMAN INTERFACE WILL 
COME UP IN SINGLE-ACCESS MODE. 
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TERMINAL DEFINITION FILE 



• 


# OF TERMINALS 




• 


DEVICE - NAME 




t 


USER - ID 







PARTITION - SIZE 


:SD: CONFIG/TERMINALS 





MAX - PRIORITY 


EXAMPLE OF FOUR TERMINALS 


• 


UNIT - PATHNAME 


/i 



Tl, 42,90 <CR> 

T0,65535,8O,21O,:SD:SPECLI <CR> 
T3, 85, 64,220 <CR> 
T2, 85,64,225 <CR> 
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USER DEFINITION FILE 



• 


USER- ID 




t 


PASSWORD 




• 


DEFAULT-PARTITION 







MAX-PARTITION 







MAX-PRIORITY 


:SD:C0NFIG/USER/65535 





DEFAULT-PREFIX 


EXAMPLE OF ONE USER 





I NIT-PATHNAME 


65535, PASS, 64<CR> 

120<CR> 

190<CR> 

:SD: USER/65535 <CR> 



A COMPLETE DESCRIPTION OF THESE FILES IS FOUND IN THE IRMX 86 
CONFIGURATION GUIDE. 
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******* LAB EIGHT (H.I. CONFIG THROUGH ICM ******* 



DBJECTIVES: 



THE STUDENT WILL USE THE INTERACTIVE CONFIGURATION UTILITY (ICU) 
TO CREATE A SINGLE ACCESS SYSTEM 

THIS SYSTEM WILL CONTAIN 
. - A NUCLEUS JOB 

- A BIOS JOB 

- A EIOS JOB 

- A LOADER JOB 

- A HUMAN INTERFACE JOB 



STEP! : 



USE THE ATTACH$FILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME"/LAB8) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAMEVLAB8 AS :LAB: 
* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 
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******* LAB EIGHT (H.I. CONFIG THROUGH ICU) ******* 



STEP2: 



THE flCU) IS INVOKED BY TYPING THE FOLLOWING 
-ICU86 :LAB:ICU.DEF 

* WHERE ICU.DEF IS THE NAME OF THE FILE WE HAVE CHOSEN TO CONTAIN 
THE INFORMATION NEEDED TO CONFIGURE OUR O.S. 

WHEN THE ICU SIGN ON ENTER THE COMMAND C , TO MODIFY THE SCREENS 



STEP3: 



* TRY FILLING THE SCREENS WITHOUT LOOKING AT THESE FIRST, 
THEN MATCH YOUR ENTRIES TO THE ONES GIVEN HERE 

* IF YOU DO NOT UNDERSTAND AN ENTRY TYPE ? 

- E.G. OSP?<cr> 

* SOME OF THE SCREENS NEEDED FOR OUR LAB EIGHT CONFIGURATION FOLLOW 

Type : RAM = 0104H, 24FFH 
Type : RAM = 26B6H, F7FFH 



Human Interface 

(ICL) Initial Command Line Size (O-OFFFFH) 
(CNM) Command Name Length (0-255) - 
(SYS) System Directory (1-45 characters) 

:SD: SYSTEM 
(DRP) Default Resident Initial Program (Yes/No) 
(RIP) Resident Initial Program (1-45 characters) 

Default 
(CDN) Configuration Device Name (1-14 chars) 
(PMI) Human Interface Pool Minimum (O-OFFFFH) 
(PMA) Human Interface Pool Maximum (O-OFFFFH) 
(HIR) Human Interface in ROM ( Yes/No) 



0100H 
0030H 



Yes 



:SD: 
0260H 
FFFFH 
No 



HI Jobs 

(MIN) Jobs Minimum Memory (O-OFFFFH pages) 0200H 

(MAX) Jobs Maximum Memory (O-OFFFFH pages) OOOOH 

(NPX) Numeric Processor Extension Used (Yes/No) Yes 

Resident User 

(TDN) Terminal Device Name (1-12 Characters) TO 
(MTP) Maximum Task Priority (0-OFFH) 00A0H 

(UID) User ID Number (O-OFFFFH) OOOOH 

(MIN) Minimum Memory Required (O-OFFFFH) 1000H 
(MAX) Maximum Memory Required (O-OFFFFH) FFFFH 
(IPP) Initial-Program Pathname (RESIDENT/1-45 Characters) 

RESIDENT 
(DEF) Default Directory 0.-45 characters) 

:SD:USER 
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******* 


Prefixes 




Prefix : 


.-45 characters 


Prefix : • 


$: 


Prefix : 


PROG: 


Prefix : 


'SYSTEM: 


Prefix : 


LANG: 


Prefix : 





LAB EIGHT (H.I. CONFIG THROUGH ICU) ******* 



HI Logical Names 

Logical Name : logical_name,path_name 
(1-12 Chars ,1-45 Chars) 



Logical Name : WORK, 
Logical Name : LANG, 
Logical Name : PROG, 



SD: USER/WORK 

SD:LANG 

SD:USER/PROG 



EIOS 

(ASC) All Sys Calls in EIOS " Req 

(ABR) Automatic Boot Device Recognition (Yes/No) Yes 

(DLN) Default System Device Logical Name (1-12 characters) SD 

(DPN) Default System Device Physical Name (1-12 characters) I WO 

(DFD) Default System Device File Driver (Phys/Str/Named) Named 

(DO) Default System Device Owners ID (0-OFFFFH) 0000H 

(EBS) Internal Buffer Size (0-OFFFFh) 0400H 

(DDS) Default 10 Job Directory Size (5-0FF0h) 0020H 

(ITP) Internal EIOS Task's Priorities (0-OFFH) 0083H 

(PMI) EIOS Pool Minimum (0-OFFFFH) 0180H 

(PMA) EIOS Pool Maximum (0-OFFFFH) ' 0180H 

(EIR) Extended I/O System in ROM (Yes/No) No 



Logical Names 

Logical Name : logical_name,device_name,f ile_driver, owners-id 

(1-12 Chars ,1-14 Chars ,Phvsical/Stream/Named, 0-OFFFFH) 

BB, BB, Physical, 0000H 

STREAM, STREAM, Stream, 0000H 

FDO, WFDDO, Named, FFFFH 



Logical Name 
Logical Name 
Logical Name 



Intel 
(IIL 
(OIL 
(UDP 
(USP 
IRP 
(ICP 
(IRC 
(IRM 
(ORP 
(OCP 
(ORC 
(ORM 

Inte 
(IL) 
(ITP 
(WIP 



Terminal Driver 

Input Interrupt Level (Encoded) 
Output Interrupt Level (Encoded) 
USART Data Port (0-OFFFFH) 
USART Status Port (0-OFFFFH) 
8253 Input Rate Port (0-OFFFFH) 
8253 Input Control Port (0-OFFFFH) 
8253 Input Counter Number (0-2) 
Input Rate Maximum (0-OFFFFFFFFH) 
8253 Output Rate Port (0-OFFFFH) 
8253 Output Control Port (0-OFFFFH) 
8253 Output Counter Number (0-2) 
Output Rate Maximum (0-OFFFFFFFFH) 

iSBC 215/218 Driver 
Interrupt Level (Encoded Level) 
Interrupt Task Priority (0-OFFH) 
Wakeup I/O Port (0-OFFFFH) 



0068H 

0078H 

00D8H 

OODAH 

00D4H 

00D6H 

0002H 

00012C00H 

0000H 

0000H 

0000H 

00000000H 



0058H 
0082H 
0100H 
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******* LAB EIGHT (H.I. CONFIG THROUGH ICU) ******* 



Intel iSBC 215/218 Unit Information 

(NAM) Unit Info Name (1-17 Chars) 

(MR) Maximum Retries (0-OFFFFH) 

(CS) Cylinder Size (O-OFFFFH) 

(NO Number of Cylinders (0-OFFFFH) 

(NFH) Number of Fixed Platters/Disk (0-OFFH) 

(NRH) Number of Remove Platters/Disk (0-OFFH) 

(NS) Number of Sectors/Track (0-OFFFFH) 

(NAC) Number of Aux. Cylinders (0-OFFH) 

(SSN Starting Sector Number (0-OFFFFFFFFH) 

(BTI) Bad Track Information (Yes/No) 

Intel iSBC 215/218 Unit Information 

(NAM) Unit Info Name (1-17 Chars) 

(MR) Maximum Retries (0-OFFFFH) 

CS) Cylinder Size (0-OFFFFH) 

(NC) Number of Cylinders (0-OFFFFH) 

(NFH) Number of Fixed Platters/Disk (0-OFFH) 

(NRH) Number of Remove Platters/Disk (0-OFFH) 

(NS) Number of Sectors/Track (0-OFFFFH) 

(NAC) Number of Aux. Cylinders (0-OFFH) 

SSN) Starting Sector Number (0-OFFFFFFFFH) 

(BTI) Bad Track Information (Yes/No) 

Intel iSBC 215/218 Unit Information 

(NAM) Unit Info Name (1-17 Chars) 

(MR) Maximum Retries (0-OFFFFH) 

(CS) Cylinder Size (0-OFFFFH) 

(NO Number of Cylinders (0-OFFFFH) 

(NFH) Number of Fixed Platters/Disk (0-OFFH) 

(NRH) Number of Remove Platters/Disk (0-OFFH) 

(NS) Number of Sectors/Track (0-OFFFFH) 

(NAC) Number of Aux. Cylinders (0-OFFH) 

SSN) Starting Sector Number (0-OFFFFFFFFH) 

(BTI) Bad Track Information (Yes/No) 

Intel iSBC 215/218 Unit Information 

(NAM) Unit Info Name (1-17 Chars) 

(MR) Maximum Retries (0-OFFFFH) 

(CS Cylinder Size (0-OFFFFH) 

(NO Number of Cylinders (0-OFFFFH) 

(NFH) Number of Fixed Platters/Disk (0-OFFH) 

(NRH) Number of Remove Platters/Disk (0-OFFH) 

(NS) Number of Sectors/Track (0-OFFFFH) 

(NAC) Number of Aux. Cylinders (0-OFFH) 

(SSN) Starting Sector Number (0-OFFFFFFFFH) 

(BTI) Bad Track Information (Yes/No) 



uinfo_215gen 

0009H 

0000H 

0001H 

0001H 

0000H 

000CH 

0001H 

00000000H 

Yes 



uinfo_215w 

0009H 

0000H 

0208H 

0005H 

0000H 

000CH 

000AH 

00000000H 

Yes 



uinfo_215pt 

0009H 

0000H 

01D2H 

0003H 

0000H 

000CH 

0006H 

00000000H 

Yes 



uinfo_215f 

0009H 

OOOOH 

004DH 

0000H 

0001H 

001AH 

OOOOH 

OOOOOOOOH 

Yes 
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******* lab EIGHT (H.I. CONFIG THROUGH ICU) ******* 



ntel 

NAM) 

MR) 

CS) 

NC) 

NFH) 

NRH) 

NS) 

NAC) 

SSN) 

BTI) 

ntel 

NAM) 

PFD) 

NFD) 

SDD) 

SDS) 

EFI) 

GRA) 

DSZ) 

UN) 

UIN) 

UDT) 

NB) 

FUP) 

MB) 

ntel 

NAM) 

PFD) 

NFD) 

SDD) 

SDS) 

EFI) 

GRA) 

DSZ) 

UN) 

UIN) 

UDT) 

NB) 

FUP) 

MB) 



iSBC 215/218 Unit Information 

Unit Info Name (1-17 Chars) uinfo_215fd 

Maximum Retries (O-OFFFFH) 0009H 

Cylinder Size (O-OFFFFH) OQOOH 

Number of Cylinders (0-OFFFFH) 004DH 

Number of Fixed Platters/Disk (O-OFFH) OOOOH 

Number of Remove Platters/Disk '0-OFFH) 0002H 

Number of Sectors/Track (O-OFFFFH) OOIAH 

Number of Aux. Cylinders (O-OFFH) OOOOH 

Starting Sector Number (O-OFFFFFFFFH) OOOOOOOOH 

Bad Track Information (Yes/No) Yes 



iSBC 215/iSBX 218 Device-Unit Information 

Device-Unit Name '1-13 chars) 

Physical File Driver Required 'Yes/No) 

Named File Driver Required (Yes/No) 

Single or Double Density Disks (Single/Double) 

Single or Double Sided Disks (Single/Double) 

8 or 5 Inch Disks (8/5) 

Granularity 'O-OFFFFH) 

Device Size (0-OFFFFFFFFH) 

Unit Number on this Device (O-OFFH) 

Unit Info Name fl-17 Chars) 

Update Timeout (O-OFFFFH) 

Number of Buffers (nonrandom = O/rand = 1-OFFFFH) 

Fixed Update (True/False) 

Max Buffers (O-OFFH) 

iSBC 215/iSBX 218 Device-Unit Information 

Device-Unit Name (1-13 chars) 

Physical File Driver Required f Yes/No) 

Named File Driver Required (Yes /No) 

Single or Double Density Disks 'Single/Double) 

Single or Double Sided Disks (Single/Double) 

8 or 5 Inch Disks (8/5) 

Granularity (O-OFFFFH) 

Device Size (0-OFFFFFFFFH) 

Unit Number on this Device (O-OFFH) 

Unit Info Name (1-17 Chars) 

Update Timeout (O-OFFFFH) 

Number of Buffers (nonrandom = O/rand = 1-OFFFFH) 

Fixed Update (True/False) 

Max Buffers (O-OFFH) 



WO 

Yes 

Yes. 

Single 

Single 

8 

0400H 

00000400H 

OOOOH 

uinfo_215gen 

0064H 

0006H 

True 

OOFFH 



IWO 

Yes 

Yes 

Single 

Single 

8 

0400H 

01DE2000H 

OOOOH 

uinfo_215w 

0064H 

0006H 

True 

OOFFH 
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******* LAB EIGHT (H.I. CONFIG THROUGH ICU) ******* 



Inte 
NAM 
PFD 
NFD 
SDD 
SDS 
EFI 
GRA 
DSZ 
UN) 
UIN 
UDT 
NB) 
FUP 
MB) 

nte 



PFD 
NFD 
SDD 
SDS 
EFI 
GRA 
DSZ 
UN) 
UIN 
UDT 
NB) 
FUP 
MB) 

nte 
NAM 
PFD 
NFD 
SDD 
SDS 
EFI 
GRA 
DSZ 
UN) 
UIN) 
UDT) 
NB) 
FUP) 
(MB) 



iSBC 215/iSBX 218 Device-Unit Information 

Device-Unit Name (1-13 chars) PWO 

Physical File Driver Required (Yes/No) Yes 

Named File Driver Required (Yes/No) Yes 

Single or Double Density Disks (Single/Double) Single 

Single or Double Sided Disks (Single/Double) Single 

8 or 5 Inch Disks (8/5) 8 

Granularity (0-OFFFFH) 0400H 

Device Size (O-OFFFFFFFFH) 0102COOOH 

Unit Number on this Device (O-OFFH) OOOOH 

Unit Info Name (1-17 Chars) uinfo_215pt 

Update Timeout (O-OFFFFH) 0064H 
Number of Buffers fnonrandom = 0/rand = 1-OFFFFH) 0006H 

Fixed Update (True/False) True 

Max Buffers (O-OFFH) OOFFH 

iSBC 215/iSBX 218 Device-Unit Information 

Device-Unit Name (1-13 chars) WFO 

Physical File Driver Required ( Yes/No) Yes 

Named File Driver Required (Yes/No) Yes 

Single or Double Density Disks (Single/Double) Single 

Single or Double Sided Disks (Single/Double) Single 

8 or 5 Inch Disks (8/5) 8 

Granularity (0-OFFFFH) 0080H 

Device Size (O-OFFFFFFFFH) 0003E900H 

Unit Number on this Device (OtOFFH) 0008H 

Unit Info Name (1-17 Chars) uinfo_215f 

Update Timeout (0-OFFFFH) 0064H 
Number of Buffers (nonrandom = O/rand = 1-OFFFFH) 0006H 

Fixed Update (True/False) True 

Max Buffers (O-OFFH) OOFFH 

iSBC 215/iSBX 218 Device-Unit Information 

Device-Unit Name (1-13 chars) WFDO 

Physical File Driver Required (Yes/No) Yes 

Named File Driver Required (Yes/No) Yes 

Single or Double Density Disks (Single/Double) Double 

Sinqle or Double Sided Disks (Single/Double) Single 

8 of 5 Inch Disks (8/5) 8 

Granularity (0-OFFFFH) 0100H 

Device Size (O-OFFFFFFFFH) 0007C500H 

Unit Number on this Device (O-OFFH) 0008H 

Unit Info Name (1-17 Chars) uinfo 215f 

Update Timeout (0-OFFFFH) 0064H" 
Number of Buffers (nonrandom = 0/rand = 1-OFFFFH) 0006H 

Fixed Update (True/False) True 

Max Buffers (O-OFFH) OOFFH 
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******* LAB EIGHT (H.I. CONFIG THROUGH ICU) ******* 



ntel 

NAM) 

PFD) 

NFD 

SDD) 

SDS) 

EFI) 

GRA) 

DSZ) 

UN) 

UIN) 

UDT) 

NB) 

FUP) 

MB) 



iSBC 215/iSBX 218 Device-Unit Information 

Device-Unit Name (1-13 chars) WFDDO 

Physical File Driver .Required (Yes/No) Yes 

Named File Driver Required (Yes/No) Yes 

Single or Double Density Disks (Single/Double) Double 

Single or Double Sided Disks (Single/Double) Double 

8 or 5 Inch Disks (8/5) 8 

Granularity (O-OFFFFH) 0100H 

Device Size (0-OFFFFFFFFH) 000F9700H 

Unit Number on this Device (0-OFFH) 0008H 

Unit Info Name (1-17 Chars) uinfo_215fd 

Update Timeout (O-OFFFFH) 0064H 
Number of Buffers (nonrandom = 0/rand = 1-OFFFFH) 0006H 

Fixed Update (True/False) True 

Max Buffers (0-OFFH) OOFFH 



***** 



THIS JOB SUPPLIES THE INTERRUPT FOR THE MONITOR **** 



Jser 

;ods) 
;pmi) 

'PMAJ 

'MOB 

*MTK) 

'MPR) 

[AEH) 

:em) 

r PV) 

:tp) 

r TSA) 

:dsb) 

;ssa) 

!SS) 

:npx) 



Jobs 

Object Directory Size (0-OFFOH) OOOAH 

Pool Minimum (20H - OFFFFH) 0030H 

Pool Maximum (20H - OFFFFH) FFFFH 

Maximum Objects (1 - OFFFFH) FFFFH 

Maximum Tasks (1 - OFFFFH) FFFFH 

Maximum Priority (0 - OFFH) OOOOH 

Address of Exception Handler (CS:IP) OOOOHrOOOOH 
Exception Mode (Never/Prog/Eny iron/All) Never 

Parameter Validation (Yes/No) Yes 

Task Priority (0-OFFH) OOOOH 

Task Start Address (CS:IP) 008OH:0002H 

Data Seqment Base (O-OFFFFH) OOOOH 

Stack Segment Address (SS:SP) OOOOHrOOOOH 

Stack Size (O-OFFFFH) 0200H 

Numeric Processor Extension Used (Yes/No) No 



[ncludes and Libraries 
3 ath Name (1-45 Characters) 
(UDF) UDI Includes and Libs 

/RMX5.0/DUDI/ 
(HIF) Human Interface Includes and Libs 

/RMX5.0/DINCLSLIBS/ 
(EIF) Extended I/O System Includes and Libs 

/RMX5.0/DINCLSLIBS/ 
(ALF) Application Loader Includes and Libs 

/RMX5.0/DL0ADER/ 
(BIF) Basic I/O System Includes and Libs 

/RMX5.0/DINCLSLIBS/ 
(THF) Terminal Handler and Debugger Includes and Libs 

/RMX5.0/DDEBTH/ 
(NUF) Nucleus and Root Job Includes and Libs 

/RMX5.0/DNUCLUS/ 
(ILF) Interface Libraries 

/RMX5.0/DUTILS/ 
(CAF) Crash Analyzer Includes and Libs 

/RMX5.0/DUDI/ 
(DTF) Development Tools Path Names 

/LANG/ 
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******* LAB EIGHT (H.I. CONFIG THROUGH ICU) ******* 

STEP4: 

AFTER YOU ENTER ALL OF THE SCREENS ENTER G TO GENERATE 

EXIT THE ICU 

SUBMIT THE ICU.CSD FILE TO GENERATE YOUR SYSTEM 

-SUBMIT :LAB: ICU.CSD 

STEP5: 

YOU MUST NOW ADD THE SDB TO THE SYSTEM, 
USING THE LIB86 UTILITY 

-LIB86 
DELETE :LAB:RMX86(INT3TASKMOD) 
ADD /DINT3/INT3JOB to :LAB:RMX86 
EXIT 

STEP6: 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /"TEAM NAME"/LAB8/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION . 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 
( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 
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CHAPTER 14 
UNIVERSAL DEVELOPMENT INTERFACE 

§ SPECIFICATIONS 

• LIBRARIES 

t DEVELOPMENT PROCESS 

• SYSTEM CALLS 



V 



r 



WHAT /WHY UDI? 
UNIVERSAL DEVELOPMENT INTERFACE 

UDI IS A SPECIFICATION OF A SET OF PROCEDURE CALLS THAT ARE 
USED TO REQUEST OPERATING SYSTEM FUNCTIONS. 

FUNCTIONS ARE IMPLEMENTED BY MODULES THAT TRANSLATE FROM THE 
UDI STANDARD TO THE ACTUAL OPERATING SYSTEM CALLS. 

EACH INTEL OPERATING SYSTEM FOR THE lAPX 86,88 FAMILY PROVIDES 
A UNIVERSAL DEVELOPMENT INTERFACE OR A SUBSET THEREOF. 



UDI 



* ,, n.V ^PLJ £4Iiq^R | 0(jfAM— f~ 



V 
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UDI FUNCTIONS 



THE KINDS OF FUNCTIONS THAT ARE AVAILABLE THROUGH UDI PROCEDURE 
CALLS INCLUDE: 

• CREATING AND BREAKING CONNECTIONS TO DATA FILES 

t OPENING, READING, SEEKING, WRITING, AND CLOSING DATA FILES 

• CONTROLLING PROGRAM EXECUTION 

• CONTROLLING MEMORY ALLOCATIONS 

• HANDLING SYSTEM EXCEPTION CONDITIONS 

• CONTROLLING THE PROCESSING OF CONSOLE INPUT & PARSING 
COMMAND LINES 

FETCHING THE CURRENT DATE AND TIME 
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LIBRARIES 



*\ 



THE iRMX 86 OPERATING SYSTEM SUPPORTS UDI BY PROVIDING 
UDI INTERFACE LIBRARIES. 



LINK 



LINK 



INTEL APPLICATION LANGUAGES (ASSEMBLY, PLM, 


'ASCAL, FORTRAN) 


RUN-TIME LIBRARIES 






UDI JOB 






OPERATING SYSTEM 




lAPX 86, 88 HARDWARE 
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r 



SOFTWARE DEVELOPMENT PROCESS 
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CAREFUL! 




YOU CAN MAKE OPERATING SYSTEM CALLS DIRECTLY FROM YOUR 
APPLICATION (SUBJECT TO SYSTEM AND LANGUAGE RESTRICTIONS). 



IF YOU DO SO, HOWEVER, YOU MAY NOT BE ABLE TO TRANSPORT 
YOUR APPLICATION TO ANOTHER OPERATING ENVIRONMENT. 



ADHERING TO UDI SPECIFICATIONS ENSURES THAT YOUR APPLICATION 
REMAINS OPERATING-SYSTEM INDEPENDENT AND TRANSPORTABLE. 
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THE iRMX OPERATING SYSTEM CONSISTS OF A NUMBER OF SUBSYSTEMS 



A 



RMX LAYERS 


DESCRIPTION 


NUCLEUS 


THE CORE OF THE iRMX 86 OPERATING SYSTEM 




AND IS REQUIRED FOR EVERY APPLICATION 




SYSTEM 


TERMINAL HANDLER 


PROVIDES A REAL-TIME INTERFACE BETWEEN 




YOUR TERMINAL AND OTHER SOFTWARE. 


BASIC I/O SYSTEM 


PROVIDES ASYNCHRONOUS FILE ACCESS 




CAPABILITIES 


EXTENDED I/O SYSTEM 


PROVIDES HIGH LEVEL, SYNCHRONOUS FILE 




ACCESS CAPABILITIES 


APPLICATION 


PROVIDES THE CAPABILITY TO LOAD OBJECT 


LOADER 


FILES INTO MEMORY FROM DISK 


HUMAN INTERFACE 


PROVIDES AN INTERACTIVE INTERFACE BETWEEN 




A USER AND SOFTWARE 
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UDI CALLS AND iRMX 86 SYSTEM CALLS 



UDI CALLS 


iRMX 86 SYSTEM CALLS 


SUBSYSTEMS 


DQSALLOCATE 


RQ$CREATE$SEGMENT 


NUCLEUS 


DQSATTACH 


RQ$S$ATTACH$FILE 


EXTENDED I/O SYSTEM 


DQ$CHANGE$EXTENSION 


(NONE) 


(NONE) 


DQSCLOSE 


RQ$S$CLOSE 


EXTENDED I/O SYSTEM 


DQSCREATE 


RQ$S$CREATE$FILE 
RQ$S$6ET$FILE$STATUS 


EXTENDED I/O SYSTEM 


DQ$DECODE$EXCEPTION 


RQ$C$FORMAT$EXCEPTION 


HUMAN INTERFACE 


DQSDELETE 


RQ$DELETE$FILE 


EXTENDED I/O SYSTEM 


DQSDETACH . 


RQ$S$DELETE$CONNECTION 
RQ$S$CLOSE 


EXTENDED I/O SYSTEM 


DQSFREE 


RQ$DELETE$SEGMENT 


NUCLEUS 
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f UDI CALLS AND iRMX 86 SYSTEM CALLS 




UDI CALLS 


iRMX 86 SYSTEM CALLS 


SUBSYSTEMS 


DQ$GET$ARGUMENT 


RQ$C$GET$CHAR 


HUMAN INTERFACE 


DQ$GET$CONNECTION$STATUS 


RQ$S$GET$CONNECTION$STATUS 


EXTENDED I/O SYSTEM 




RQ$A$GET$FILE$STATUS 


BASIC I/O SYSTEM 


DQ$GET$EXCEPTION$HANDLER 


RQ$GET$EXCEPTION$HANDLER 


NUCLEUS 


DQ$GET$SIZE 


RQ$GET$SIZE 


NUCLEUS 


DQ$GET$SYSTEM$ID 


(NONE) 


(NONE) 


DQ$GET$TIME 


RQ$GET$TIME 


BASIC I/O SYSTEM 


DQSOPEN 


RQ$S$OPEN 


EXTENDED I/O SYSTEM 


DQSOVERLAY 


RQ$S$OVERLAY 


APPLICATION LOADER 


DQ$READ 


RQ$S$READ$MOVE 


EXTENDED I/O SYSTEM 


DQSRENAME 


RQ$S$RENAME$FILE 


EXTENDED I/O SYSTEM 


DQSSEEK 


RQ$S$SEEK 


EXTENDED I/O SYSTEM 


DQSSPECIAL 


RQ$S$SPECIAL 


EXTENDED I/O SYSTEM 


DQ$SWITCH$BUFFER 


RQ$SETS$PARSE$BUFFER 


HUMAN INTERFACE 


DQ$TRAP$EXCEPTION 


RQ$S$TRUNCATE$FILE 


EXTENDED I/O SYSTEM 


\^ DQSWRITE 


RQ$S$WRITE$MOVE 


EMENDED I/O SYSTEM 
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EXAMPLE CALL TO REQUEST MEMORY 



V. 



DECLARE STATUS . WORD; 
DECLARE ARRAYJASE SELECTOR; 



ARRAY JASE = DQ$ALL0CATE(128, aSTATUS); 

• IF THE REQUEST FAILS THEN 

ARRAYJASE EQUALS 0FFFFH 
AND STATUS - E$MEM 
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V. 



A 



ERROR REPORTING 



UDI PROCEDURES RETURN A CONDITION CODE THAT INDICATES THE RESULTS 
OF EXECUTING A UDI PROCEDURE. 

• YOU MUST CHECK THE CONDITION CODE AFTER EACH UDI CALL TO 
ENSURE PROPER RESULTS 



TABLE 6-2. IRMX 86 EXCEPTION CODES AND MNEMONICS 
HEX CODE MNEMONIC HEX CODE MNEMONIC 



0000 


E$OK 


0001 


E$TIME 


0002 


E$MEM 



0065 


E$EOF 


0066 


E$FIXUP 


0067 


E$NO$LOADER$MEM 



(SEE COMPLETE LISTING IN RUN TIME SUPPORT MANUAL) 
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OTHER UDI FACTS 

INTERRUPT HANDLING 

PROGRAMS THAT RUN UNDER THE IRMX 86 OPERATING SYSTEM SHOULD 

USE IRMX 86 INTERRUPT MANAGEMENT TECHNIQUES TO HANDLE INTERRUPTS. 

• THE UDI LIBRARIES DO NOT INCLUDE INTERRUPT MANAGEMENT. 
REENTRANCY 

UDI LIBRARIES ARE FULLY REENTRANT WITH THE FOLLOWING RESTRICTIONS: 

• EACH JOB MUST HAVE ITS OWN COPY OF THE UDI INTERFACE LIBS. 

MULTITASKING 

• THE UDI LIBRARIES ARE FULLY COMPATIBLE WITH A 
MULTITASKING ENVIRONMENT. HOWEVER, THERE ARE NO UDI 
CALLS TO CREATE AND DELETE TASKS. 
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LOGICAL NAMES 

THE UDI USES CERTAIN LOGICAL NAMES TO MEAN SPECIAL THINGS. 
FOR EXAMPLE, :LP: MEANS "LINE PRINTER", :CO: MEANS "CONSOLE 
OUTPUT", AND "CI" MEANS "CONSOLE INPUT". 

REQUIREMENTS 



A UDI JOB MUST BE CONFIGURED IN YOUR SYSTEM WITH I.C.U.86. 
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APPENDIX 




APPENDIX A 
ALTER EDITOR 

• INSERTION 

• CORRECTING MISTAKES 

• ENDING THE EDITING SESSION 



r 



INVOCATION 



"N 



RUN ALTER : Fl : LABI . ASM 



V 



r 



~\ 



V. 



ALTER IS MENU DRIVEN 
INITIAL SCREEN 



EOF MARKER 



CURSOR 
TEXT AREA 





MESSAGE LINE 
MENU 



• TO GET NEXT MENU: 



TAB 



] 



A-l 



r 



THE MENUS 



"\ 



MENU 1 



TAB 


MENU 2 


TAB 


MENU 3 


'. TAB J 




UaeaU FM -«M Gal 



H« kiaart Jm« Macro OMar OaH 



?rap«ea Sat Tag yarn Xchanoa 



TO INVOKE A COMMAND, KEY THE FIRST LETTER OF THE COMMAND, 



r 



INSERTING NEW TEXT 



V 




Hex ( Insert ) Jump Macro 



• TO INSERT TEXT, TYPE I 



A- 2 



r 



INSERTION 



"\ 



V 



KEYSTROKES 



SCREEN 



I tM . EOF 



CURSOR 



MESSAGE LINE p [insert] 



r 



INSERTION 



A 



KEYSTROKES 



Now is the time 
for all good mend 



RET 



J 



SCREEN 



Now is the time 
for all good mend '. 



^- EOF 
CURSOR 




V. 
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r 



CORRECTING MISTAKES 



"\ 



I 



KEYSTROKES 



SCREEN 



V. 



RUBOUT 



Now ia the time 
for all good men: 



Qnserf] 



r 



ENDING INSERTION 



A 



KEYSTROKES 



SCREEN 



ESC 



Now is the time 
for an good men: 



MENU 



Again Block Delete Execute 
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r 



CURSOR CONTROL 



~\ 



V 



■ 


■I] 

HOME 



• ARROW KEYS MOVE CURSOR ONE SPACE OR LINE FOR EDITING 



r 



-\ 



DELETING TEXT 



| CONTROL ] [7] DELETES CHARACTER AT CURSOR 



CONTROL 1 [z] DELETES LINE ON WHICH CURSOR IS POSITIONED 



CONTROL 







UNDO-RESTORES DELETED CHARACTERS 



THESE ALSO WORK DURING INSERTION 
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r 



EXITING ALTER 



"\ 



KEYSTROKES 



— :i^0r: 






V 



■\ 



r 



EXITING ALTER, CONT. 



KEYSTROKES 
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v 



ADVANCED ALTER FEATURES 

• EDITING MULTIPLE FILES DURING 
ONE SESSION 

• BLOCK MOVES 



r 



>* 



ALTER BUFFERS 



START 
UP 



PRIMARY BUFFER 



OTHERS 
<V*COMMAND 



SECONDARY BUFFER 




BLOCK BUFFER 



V. 



• SECONDARY BUFFER ALLOWS SEARCHING AND BORROWING FROM ANOTHER FILE 

• BLOCK BUFFER USED FOR MOVING OR DELETING BLOCKS OF TEXT 
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ALTER INVOCATION 



"\ 



- RUN ALTER INPUT FILE [/OTHER INPUT FILE] <CR> 

• OTHER INPUT FILE IS FILE TO BE EDITED IN SECONDARY BUFFER 

EXAMPLES : 

- RUN ALTER :F1: LABI. ASM <CR> 

- RUN ALTER : Fl: LABI. ASM, :F1: LABI. LST <CR> 

OR 

- RUN ALTER :F1: LABI. ASM- LST <CR> 



"\ 



r 



START UP 



ALTER MODES 



C 



INSERT MODE 



<: 



D 



<ESC> 



FIRST LETTER 
OF COMMAND 



MAIN MENU 



C 



) <ESC> OR fC (~ 



COMMANDS 



) 



<ESC> 



XCHANGE MODE 



D 



V 



<ESC> EXECUTES COMMAND & RETURNS TO MAIN MENU 
tc ABORTS COMMAND 
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XCHANGE MODE 



"N 



V 



• ALLOWS 'TYPING OVER' OF TEXT 



• <ESC> RETURNS ALTER TO MAIN COMMAND LEVEL 



r 



CURSOR MOVEMENT AND PAGING 



A 



HOME 



D- 



HOME 



HOME 



JB 



MOVES CURSOR TO END OF LINE 



MOVES CURSOR TO BEGINNING OF LINE 



- PAGES DOWN 



HOME j f | | - PAGES 



UP 
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ALTER COMMANDS 



^ 



r 



KEYSTROKES 



HOME 



DELETE 



SCREEN 



INTEL CORPORATION 
3NTEL CORPORATION 
33TEL CORPORATION 
3NTEL CORPORATIONS 



t DELETES AND MOVES TEXT TO BLOCK USING BEGIN AND END MARKERS (a) 



• RETRIEVE TEXT WITH GET COMMAND 



V 
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BLOCK — FOR COPYING TEXT 



"N 



KEYSTROKES 



SCREEN 



HOME 



INTEL CORPORATION 
8NTEL CORPORATION 
aaTEL CORPORATION 
3NTEL CORPORATIONS 
INTEL CORPORATION 



V. 



• COPIES TEXT TO BLOCK BUFFER USING BEGIN & END MARKERS (3) 



• RETRIEVE TEXT WITH GET COMMAND 



r 



GET — RETRIEVING THE BLOCK BUFFER 



A 



KEYSTROKES 



ESC 



• RETRIEVES BLOCK BUFFER TO CURRENT CURSOR POSITION 



NOTE: MAY ALSO BE USED TO 'GET' DISK FILES 



V 



A-ll 



r 



FINDING A STRIN6 



"N 



KEYSTROKES 



F "STRING" 



ESC 



• SEARCHES FORWARD FOR FIRST OCCURENCE OF "STRING" AND 
MOVES CURSOR IF FOUND 



• -F COMMAND SEARCHES BACKWARDS 



r 



REPLACING TEXT 



"\ 



KEYSTROKES 



R "OLD STRING" 



ESC 



NEW STRING' 



ESC 



t REPLACES FIRST OCCURENCE OF "OLD STRING" WITH "NEW STRING" AND 
MOVES CURSOR IF FOUND 



V 



§ ? REPLACE PROMPTS YOU: 

OK TO REPLACE? (Y OR IN]) 
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^^ 

' REPEAT FUNCTION * 



• OPTIONAL FACTOR THAT INDICATES THE NUMBER OF TIMES TO 
EXECUTE A COMMAND 



• PRECEDES ENTERING OF COMMAND LETTER 

• / - MEANS REPEAT FOREVER 



EXAMPLE: 
10F "SAM" <ESC> 

FINDS TENTH OCCURENCE OF SAM 



V 



r 



v. 



JUMPING TO BEGINNING OR END OF FILE 



KEYSTROKES 



JS 
OR 

JE 



t JS MOVES CURSOR TO BEGINNING OF FILE 
t JE MOVES CURSOR TO END OF FILE 
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INSERTING CONTROL CHARACTERS 



KEYSTROKES 



H I "HEX VALUE* 



ESC 



] 



t INSERTS CONTROL CHARACTER AT CURRENT CURSOR POSITION AND 
DISPLAYS IT AS ? 



EXAMPLE: r 



H I 0C ESC 



INSERTS A FORM FEED CHARACTER 



r 



DISPLAYING CONTROL CHARACTERS 



KEYSTROKES 



V 



H 



ESC 



DISPLAYS HEXADECIMAL VALUE OF CHARACTER AT CURRENT CURSOR POSITION 
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QUIT 



*\ 



KEYSTROKES 



MENU PROMPT UNE 



Abort Exit Init Update Write 



V 



SUBCOMMANDS: 

A - ABORT - ALL CHANGES LOST; RETURN TO OPERATING SYSTEM 

E - EXIT - RETURN TO OPERATING SYSTEM; FILE IS UPDATED 

I - INIT - RESTARTS EDITING SESSION; ALL CHANGES LOST 

U - UPDATE - UPDATES FILE; DOES NOT RETURN TO OPERATING SYSTEM 

W - WRITE - PROMPTS YOU FOR NEW FILE TO WRITE TO; DOES NOT 
RETURN TO OPERATING SYSTEM 



r 



OTHER ALTER FEATURES 



A 



• MACROS 



• DISK I/O 



• TAGS 



• ENVIRONMENT SETTINGS 



V 
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APPENDIX B 
PL/M OVERVIEW 



r 



PL/M IS A BLOCK STRUCTURED LANGUAGE 



MYSPROG: 



DO; 



DECLARATIONS 



EXECUTABLE 
STATEMENTS 



END; 



• RESERVE SPACE IN MEMORY 

t GIVE A NAME TO THAT SPACE 

• CAUSE WORK TO BE PERFORMED 



PL/M STATEMENT FORMAT 



• FREE FORMAT 

• ENDS WITH A SEMICOLON 

• COMMENTS 

- MAY BE USED WHEREVER A SPACE IS LEGAL 

- /'THIS IS A COMMENT */ 
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BASIC PL/M CONSTRUCTS 



"\ 



• SEQUENTIAL 



• CONDITIONAL 



t LOOPING 




PL/M 
SAMPLE PROGRAM 



SERIES-III PL/M-86 VI. COMPILATION OF MODULE SAMPLE1 
OBJECT MODULE PLACED IN :Fl :PROG1.0BJ 
COMPILER INVOKED BY: PLM86.86 :Fl :PROGl.PLM 



/* THIS PROGRAM ADDS TWO NUMBERS */ 



SAMPLE$1: 

DO; 

DECLARE NUM$1 BYTE, 
NUM$2 BYTE, 
SUM BYTE; 

NUM$1 - 3; 
NUM$2 * 2; 

SUM - NUM$1 + NUM$2; 

END SAMPLE$1; 



MODULE INFORMATION: 

CODE AREA SIZE 
CONSTANT AREA SIZE 
VARIABLE AREA SIZE 
MAXIMUM STACK SIZE 
15 LINES READ 
PROGRAM WARNINGS 
PROGRAM ERRORS 



0018H 
0000H 
0003H 
0000H 



24D 
OD 
3D 
OD 
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A VARIABLE HAS: 



A 
NAME 




CONTENTS 



V 



NAME - FIXED THRUOUT. PROGRAM 
CONTENTS - TRANSIENT .... 



VARIABLE DECLARATIONS 

• BEFORE ANY VARIABLE CAN BE USED IT MUST 
BE DEFINED IN A DECLARATION STATEMENT 

t VARIABLE DECLARATIONS 

- RESERVE SPACE IN MEMORY 

- ASSOCIATE AN IDENTIFIER WITH THAT SPACE 

- PRECEDE EXECUTABLE STATEMENTS 



PROG: DO; 



DECLARE SPOT BYTE; 
SPOT =5; 



END; 



SPOT 



MEMORY 
UZ.,&,£4,i. ,2,1,44 



OOOOOlOl 
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PL/M VARIABLE TYPES 



DATA TYPES 


BYTES 


RANGE 


PL/M-80 


PL/M- 86 


BYTE 
ADDRESS 


BYTE 
WORD 


1 
2 


TO 255 
TO 65,535 




DWORD 
INTEGER 

REAL 

POINTER 
SELECTOR 


<4 
2 

H 

2 OR 4 
2 


TO 2 32 - 1 
-32,768 TO 
+32,767 

1.17x10 " 38 T0 
3.37x10 38 

TO BE DISCUSSED 
LATER 

TO 65,535 



DECLARATION FORMATS 



DECLARE 


A BYTE; 


DECLARE 


B BYTE; 


DECLARE 


C BYTE; 



DECLARE 


A 


BYTE, 




B 


BYTE, 




C 


byte; 



DECLARE (A,B,C) BYTE; 
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• SIMPLIFY PROGRAM UPDATES: 

DECLARE BUFFERSSIZE LITERALLY '256'; 

DECLARE COUNT WORD; 

DECLARE BUFFER(BUFFER$SIZE) BYTE; 



COUNT = BUFFER$SIZE;/ # SAME AS: COUNT =256; V 



• IMPROVE DOCUMENTATION: 

DECLARE SPACE LITERALLY '20H'; 
DECLARE CR LITERALLY '0DH'; 
DECLARE LF LITERALLY '0AH'; 



OPERATOR PRECEDENCE 



OPERATOR 
CLASS 


OPERATOR 


PRECEDENCE 


PRECEDENCE 


( ) 


HIGh 

LOWE 


£ST 
ST 


UNARY 


-j + 


ARITHMETIC 


*, /, MOD 
+j - 


RELATIONAL 


<, =, >, <=, >=, <>, 


LOGICAL 


NOT 

AND 

OR, XOR 



• EXPRESSIONS WITH OPERATORS OF EQUAL PRECEDENCE ARE EVALUATED 
LEFT TO RIGHT 
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ARITHMETIC EXPRESSION SUMMARY 






VARIABLE TYPE 


KIND OF 
ARITHMETIC 


OPERAND 
TYPE ' 


ARITHMETIC 
OPERATION 


RESULT " 


PL/M-80 


PL/M-86 


BYTE AND 


BYTE AND 


UNSIGNED 


1 BYTE, 1 BYTE 


+ >-,*,/,MOD 


1 BYTE 


ADDRESS 


WORD 








2 BYTE 








1 BYTE, 2 BYTE 


+,-,*, /,MOD 


2 BYTE 








2 BYTE, 2 BYTE 


+,-,*,/, MOD 


2 BYTE 




DWORD 


UNSIGNED 


1 BYTE, A .BYTES 

2 BYTE.4 BYTES 
ti BYTE,'; BYTES 


+,-,*, /.MOD 


4 -BYTES 
H BYTES 

'A dyt:s 




INTEGER 


SIGNED 


INTEGER, INTEGEF 


+,-,v,raD 


INTEGER 




REAL 


FLOATING 
POINT 


REAL, REAL 


+,-,*,/ 


REAL 



J 



LOGICAL AND RELATIONAL EXPRESSION SUMMARY 



VARIABLE TYPE 


OPERAND 
TYPE 


RELATIONAL 
RESULT 


LOGICAL 
RESULT 


PL/M-80 


PL/M-86 


BYTE AND 
ADDRESS 


BYTE AND 
WORD 


1 BYTE, 1 BYTE 

1 BYTE, 2 BYTE 

2 BYTE, 2 BYTE 


1 BYTE 
1 BYTE 
1 BYTE 


1 BYTE 

2 BYTE 
2 BYTE 




DWORD 
INTEGER 

REAL 


1 BYTE, 4 BYTES 

2 BYTES, 4 BYTES 
4 BYTES, H BYTES 

INTEGER, INTEGER 
REAL, REAL 


1 BYTE 
1 HYTF 
1 BYTE 

1 BYTE 
1 BYTE 


4 BYTFS 

'! ■:! 1- 

4 BYTES 
ILLEGAL 

ILLEGAL 
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PORT INPUT AND OUTPUT 
DATA IS "READ" FROM OR "WRITTEN" TO SPECIFIED PORT 



PL/PI 80 

1 BYTE READ OR 
WRITTEN 



PL/M 86 

1 BYTE READ OR 
WRITTEN 



<VARIABLE> 



= INPUT e<PORT$EXPR »; 



OUTPUT «PORT$EXPR » = 



<VARIABLE$EXPR> 
CONSTANT 



2 BYTES READ OR 
WRITTEN 



<VARIABLE> = TNWORD KPORT$EXPR»; 

OUTWORD«PORT$EXPR» = 



<VARIABLE$EXPR> 

CONSTANT 



\ ' 



<PORT$EXPR> 


PL/M-80 


PL/M-86 


• MUST BE A 


• CAN BE A 


NUMBER OR A 


NUMBER, CONSTANT 


CONSTANT 


EXPRESSION, OR 


EXPRESSION 


EXPRESSION 


• 0< PORT$EXPR 


§ 0< PORT$EXPR< 


1255 


65535 



DO WHILE BLOCKS 



[<LABELNAME> :] DO WHILE <EXPRESSION> ; 
[<STATEMENT>] ; 



END [<LABELNAME>] j 




<STMT> 
<STMT> 



• STATEMENTS EXECUTE AS LONG AS< EXPRESSION> EVALUATES TO A NUMBER WITH 
BIT 0=1 



A 
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ITERATIVE 'DO' BLOCKS 



DO <COUNTER$VARIABLE> = <STARTEXP>TO<LIMITEXP> tBY<STEPEXP> I; 

I< STATEMENT > 1; ..." 
END; 



<r 



WHERE 

<COUNTER$VARIABLE> IS A 1 BYTE OR 2 BYTE VARIABLE 

<STARTEXP> ,<LIMITEXP>AND<STEPEXP> 
ARE EXPRESSIONS 




COUNT1. \ ^ 

LIMIT / Y 



UPDATE 
COUNT 

7F~ 



<STMT> 
< STMT > 



I 



• STATEMENTS WITHIN AN ITERATIVE DO BLOCK ARE EXECUTED REPEATEDLY 



r 



IF.. THEN 



>v 



THE CONDITIONAL STATEMENT TESTS AN EXPRESSION FOR TRUE OR FALSE 
AND CAUSES CODE TO BE EXECUTED OR BYPASSED ACCORDINGLY. 




< STMT > 



IF <EXPRESSION> THEN 
<STATEMENT> 



EXPRESSION IS TRUE IF bit0 = 1. 
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IF.. THEN.. ELSE 



~\ 



"ELSE" CAUSES AN ALTERNATE STATEMENT 
TO BE EXECUTED 



IF <EXPRESSION> 

THEN 

<STATEMENTl> ; 

[ELSE 

<STATEMENT2>;I] 



<stmt2> 




N <EXPR^ Y 



>pe 



v 



JL 



<stmt!> 



THE 'DO CASE' 



\ 



[<LABELNAME> :]DO CASE <EXPRESSION> J 
<STATEMENT> 
[<STATEMENT>] 



/•executed WHEN EXPRESSION = */ 
/* EXECUTED WHEN EXPRESSION = 1 V 



[<STATEMENT>] 
END [<• LABELNAME>] ; 



/* EXECUTED WHEN EXPRESSION ■ N */ 



IMPORTA NT: NO RANGE CHECK IS PERFORMED ON THE VALUE OF THE EXPRESSION 
AFTER IT IS COMPUTED. IF THE VALUE COMPUTED IS GREATER THAN THE 
NUMBER OF 'BASIC$STATEMENTS', THE PROGRAM CRASHES. 



V. 



J 
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DO CASE 
"N" LEGAL CASES 



-N + 1 




•\ 



DO CASE EXAMPLE 



DO CASE (stop$light$value); 
DO; 

CURRENT$STATE ■ GREEN$LIGHT; 
TIME = SHORT; 

END; 
DO; 

CURRENT$STATE = YELLOW$LIGHT; 
TIME = GOTCHA; 

END; 
DO; 

CURRENT$STATE = RED$LIGHT; 
TIME ■ ETERNITY; 

END; 



CURRENT$STATE ■ blink$yellow; 



/* CASE V 



/• CASE 1 */ 



/* CASE 2 V 



/* CASE 3 IS NULL V 
/• CASE 4 V 



END; 
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ARRAYS CAN BE USED TO MANIPULATE 
6R0UPS OF RELATED DATA ITEMS 



SORTING OFFICE | 




V 



• AN ARRAY OF BOXES FOR EACH STREET 
t EACH ARRAY HAS A NAME 

• REFER TO BOX FOR NO A HIGH STREET: 
HIGHW) 

t ALL MEMBERS OF AN ARRAY MUST BE OF 
THE SAME TYPE 



DECLARE victor i a (120) BYTE; 
DECLARE high (81) BYTE; 



r 



STORAGE OF DATA INPUT FROM TEMPERATURE SENSOR 

DATASIN: 

DO; 

DECLARE READY LITERALLY '01'; 
DECLARE TEMP$BUFFER(256) BYTE; 
DECLARE TEMP$BUFFER$PTR BYTE; 

DO TEMP$BUFFER$PTR = TO 255; 

DO WHILE INPUT ( 4 )<>READY; 
END; 



TEMP$BUFFER(TEMP$BUFFER$PTR) = INPUT ( 8 ); 



END; 



END; 



V 
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ARRAY DECLARATIONS 

DECLARE «<ARRAY$NAME> (<ARRAY$CONST>) 

PL/M-86 ONLY-^^ 
DECLARE input$buffer (128) BYTE; 



BYTE 
WORD 
(INTEGER 

feEAL 
POINTER 



input$buffer(0)' 
input$buffer(1) 



K«««<«4 



CONTIGUOUS BLOCK 
OF 128 BYTES 



input$buffer(127) 



1\\\\\\\\\S 3 



LATER 



STRUCTURES 

t LOGICAL AND PHYSICAL GROUPS OF DISSIM1LIAR, RELATED DATA ITEMS 
• A STRUCTURE MAY CONTAIN DATA ITEMS OF DIFFERENT TYPES 



DECLARE airplane STRUCTUREC 
speed BYTE, 
altitude WORD); 



AIRPLANE. speed 



AIRPLANE. ALTITUDE 



TTTTT 
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ARRAY OF STRUCTURES 



DECLARE airplane (5) STRUCTURE ( 
speed BYTE, 
altitude WORD); 



AIRPLANE(0). SPEED' 
airplane(0). ALTITUDE 



airplane(1).speed- 
airplane(l). altitude' 



AIRPLANE(4).SPEEI 
AIRPLANE (4). ALTITUDE 




N vvyvVVv v 

wr 




AIRPLANE (0) 



AIRPLANE (1) 



AIRPLANE (4) 



STRUCTURE WITH AN ARRAY AS AN ELEMENT 



DECLARE airplane STRUCTUREC 
speed BYTE, 
altitude WORD, 
engine W BYTE); 



airplane. SPEED 
airplane. altitude - 

airplane. engine(0) 
airplane. engine(I) 
airplane. engine(2) 
airplane. engine(3) 
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PROCEDURE DECLARATION 







> 


PROCEDURE HEADING 




DECLARATION PART 




EXECUTABLE PART 





MODULE$NAME: 
DO; 

KDECLARAT10N$STATEMENTS> 1 

PROCEDUREJNAME : PROCEDURE ; 

KDECLARATION$STATEMENT> ] 
< EXECUTABIE$STATEMENT> 
<END (<PROCEDURE$NAME> ] 

I <DECLARAT10N$STATEMENTS> 1 
( <EXECUTABLE$STATEMENTS> 1 

END; 



r 



PARA^ETERLESS PROCEDURE 

main: DO; 

DECLARE (result, opL op2, answer) BYTFj 



sum: PROCEDURE; 

RESULT - OPl + op2; 
END sum; 

Oel = i|; 

op2 = 5; 
CALL sum; 

ANSWER = RESULT; 
END MAIN; 



/* PROCEDURE DEFINITION * ; 

/* START OF MAIN V 
/* PROCEDURE INVOCATION */ 



• PROCEDURE ACCESSES 
GLOBAL VARIABLES 



V 
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PROCEDURE WITH PARAMETERS 



main: DO; 

DECLARE (x, y, answerD BYTE; 

DECLARE (a, b, answer2) BYTE; 

DECLARE result BYTE; 

sum: PROCEDURE (opI, op2); /* procedure definition */ 

DECLARE (opL op2) BYTE; 

result = opI + oi?2; 
END sum; 

CALL sum(x, y); /* procedure invocation */ 

answerI = .result; 

CALL sum (a-3,b-2); /* procedure invocation */ 

ANSWER2 = RESULT; 

END main; 



• TWO INPUT PARAMETERS 

• PROCEDURE OUTPUT IS RETURNED IN A GLOBAL VARIABLE 



TYPED PROCEDURES 
A SINGLE VALUE IS RETURNED 



MAIN: DO; 



DECLARE (XXANSWER) BYTE; 



SUM: PROCEDURE (OPI, 0P2) BYTE; 
DECLARE (OPI, 0P2) BYTE; 

RETURN OPI + 0P2; 
END SUM; 

X = 3; 
Y = 2; 

ANSWER = SUM (X,Y); 



/• PROCEDURE DEFINITION V 



/* PROCEDURE INVOCATION V 



V 



END MAIN; 
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VARIABLES: GLOBAL vs. LOCAL 



MAIN 



1BUFF IS "GL0BAJ7T <: 





DO; 

DECLARE BUFF (128) 1 

FILL$BU 


3YT 


E: 






: FER: 


PROCEDURE; 

DFCI ARF I RYTF. 






"I" AND PORTS IN 
ARE "LOCAL" TO 

FILLSBUFFER 


1 




■-; 




^ 




PORTS IN: 


PROCEDURE BYTE; 
END; 












BUFF (IMPORTS IN; 
END; 




CALL FILLSBUFFER; 
END; 











V. 



SCOPE OF VARIABLES 

• THE SCOPE OF A VARIABLE IS THE FULL LENGTH OF THE BLOCK, UNLESS IT 
IS REDECLARED WITHIN A NESTED BLOCK. 

• TO DETERMINE IF A VARIABLE/LABEL CAN BE USED IN A BLOCK: 

1) IF IT IS NOT DECLARED IN THE BLOCK, GO TO THE NEXT OUTER BLOCK. 

2) IF DEFINED, THE SCOPE IS SET, ELSE REPEAT 1) AND 2). 

3) IF REACH THE OUTER MOST BLOCK WITHOUT ENCOUNTERING THE 
DECLARATION, THE VARIABLE/LABEL CANNOT BE USED. 



B: 


X,R, 


z-s 








X,R,Q 

















V 
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SYNTAX * 



• DECLARE <VAR I ABLE$NAME> BASED <POINTER$VARIABLE> 

fBYTE ^ 



[(<ARRAY$CONSTANT> f] { 



WORD 
INTEGER 
REAL 
(^STRUCTUREJ 



t EXAMPLE 

SUM: PROCEDURE (OPl_PTR, 0P2_PTR, RSLT_PTR); 

DECLARE OP1-PTR POINTER, 

0P2_PTR POINTER, /* ADDRESS FOR PL/M-80 V 

RSLT.PTR POINTER: 

DECLARE OP1 BASED OP1 PTR (6) BYTE, 



| BASED VARIABLE 



BASE 



DIMENSION SPECIFIER OF BASED VARIABLE 



OP2 BASED OPl_PTR (6) BYTE, 
RESULT BASED RSLT PTR (6) BYTE; 



r 



PROGRAM TO SUM TWO ARRAYS USING BASED VARIABLES 

ARRAY$SUM: DO; 

DECLARE ANSWER (6) BYTE, TOTAL (8) BYTE, 

X (6) BYTE, A (8) BYTE, 

Y (6) BYTE, B (8) BYTE; 

SUM: PROCEDURE (OPl_PTR, 0P2_PTR, RSLT_PTR, ARRAYSIZE); 
DECLARE OPl_PTR POINTER, 

0P2.PTR POINTER, 

RSLT_PTR POINTER, /* ADDRESS FOR PL/M-80 V 

ARRAYSIZE BYTE; 

DECLARE OP1 BASED OPl_PTR (1) BYTE, 
OP2 BASED 0P2_PTR (1) BYTE, 
RESULT BASED RSLT_PTR (1) BYTE; 

DECLARE I BYTE; 

DO I = TO ARRAYSIZE; 

RESULT (I) = OPKI) + 0P2(I) NOTE: IN PL/M-80, USE 

END; ».» INSTEAD OF "a". 

END SUM; 

CALL SUMOX, aY, aANSWER, LAST (ANSWER)); 

CALL SUM OA, 3B, aTOTAL, LAST(TOTAD); 

END ARRAYSSUM; ^ 
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A "BASED VARIABLE" IS A PROCEDURE'S MOVABLE TEMPLATE FOR 
A DATA STRUCTURE DECLARED IN A CALLING PROGRAM. 



"N 



MAIN: 
DC- 
DECLARE ARRAY$1 (6) BYTE, 
ARRAY$2 W BYTE; 

ARRAY$HANDLER: PROCEDURE(ARRAY$PTR); 
DECLARE ARRAYIPTR POINTER: 
DECLARE BLOCK BASED ARRAYIPTR (I) BYTE; 

/• EXECUTABLE STATEMENTS V 

END ARRAYIHANDLER: 

CALL ARRAY$HANDLER (aARRAY$l); 

CALL ARRAYIHANDLER OARRAY$2); 
END MAIN; 



SOME PRIMARY CONTROL NAMES 



MOPRINT / PRINT (SOURCESFILE.LSTV 
SYMBOLS / NOSYMBOLS* 
XREF / NOXREF* 
DEBUG / NODEBUG* 

PL/M-86 ONLY 

OPTIMIZE (0 / 1* / 2 / 3) 

ROM/RAM* 

TYPEVNO TYPE 

SMALL* /COMPACT / MEDIUM / LARGE 

DEFAULT CONDITION 



DESTINATION OF LISTING 
GENERATE SYMBOL TABLE LISTING 
GENERATE CROSS REFERENCE LIST 
RETAINS SYMBOL TABLE 

( MINIMAL CODE OPTIMIZATION 



CONSTANT & COMMON EXPRESSIONS 
#1 PLUS LOCAL CODE OPTIMIZATION 
#2 PLUS FURTHER OPTIMIZATION 



PLACEMENT OF CONSTANTS IN CODE SEGMENT 



(SEE P. 8-6) 
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PL/M COMPILER OPERATION 



COMMAND SYNTAX: 
(j<DEVICE>7] 



PLM86 
PLM80 



<SOURCE$FILE> [<C0NTR0LS>3 



<CONTROLS> IS A SEQUENCE OF EITHER 

' <PRIMARY$CONTROLS> WHICH MUST OCCUR BEFORE SOURCE CODE 
<GENERAL$CONTROLS> WHICH MAY OCCUR ANYWHERE (INVOCATION 
OR IMBEDDED WITHIN THE SOURCE CODE.) 



V 



SOME GENERAL CONTROL NAMES 



LIST* / NOLIST 

CODE / NOCODE* 

EJECT / -• 

INCLUDE / -• 

OVERFLOW / NOOVERFLOW* (PL/M-86 ONLY) 



SUSPEND / RESUME LISTING 
GENERATE OBJECT CODE INTERLIST 
GENERATE PAGE EJECT 
INCLUDE CONTENTS OF ANOTHER FILE 
INTEGER OVERFLOW DETECT CODE 
(REQUIRES USER SUPPLIED TYPE H 

INTERRUPT SERVICE PROCEDURE. 

DISCUSSED IN CH. 16) 



DEFAULT 
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COMPILER CONTROL USAGE 



"A 



> PLM86 :F1:ALICE.SRC DEBUG SYMBOLS 0PTIMIZE(2) 



IN THE SOURCE FILE WE HAVE THE FOLLOWING: 
$CODE 



'$' MUST 
APPEAR IN 
COLUMN 1 



BIG$TIME: DO; 

SINCLUDE (:F1:PREAMB.LIT) 

SEJECT 

DECLARE CAROL BYTE; 

$EJECT 

$NOLIST 



^^ 



COMPILATION FAILS 
IF :FI: NOT READY 
OR IF :FI: PREAMB.LIT 
DOES NOT EXIST 



[< EXECUTABLE$STATEMENTS>D 
END; __ 



■ PL/M-86: SIZE CONTROL SWITCH 

ALLOCATION OF MEMORY AND THE WAY IN WHICH LOCATIONS ARE REFERENCED BY A 
PROGRAM IS DETERMINED BY THE SIZE CONTROL SWITCH. 

1. 'SMALL' - FOR PROGRAMS WITH LESS THAN 64K BYTES OF CODE AND LESS 
THAN 64K BYTES OF DATA. (MAXIMUM OF 128K BYTES.) 



2. 'COMPACT' - FOR PROGRAMS WITH A MAXIMUM OF 64K BYTES EACH OF CODE, 
DATA, AND STACK. 



3. 'MEDIUM' - FOR PROGRAMS WITH MORE THAN 64K BYTES OF CODE AND LESS 
THAN 64K BYTES OF DATA. 



4. 'LARGE' - FOR PROGRAMS WITH MORE THAN 64K BYTES OF CODE AND MORE THAN 
64K BYTES OF DATA. 



FOR GREATEST EFFICIENCY, USE THE SMALL CASE WHEN POSSIBLE. UPGRADED PL/M- 
PROGRAMS MMSJ USE THE 'SMALL' CASE. 
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APPENDIX C 



THE iRMX 86 BOOTSTRAP LOADER 





£T& 
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WHY THE NEED FOR A BOOTSTRAP LOADER? 

• MAINTENANCE COSTS GREATLY REDUCED 

- MINIMIZE THE NEED TO MANUFACTURE ROM CHIPS 

- SOFTWARE UPGRADES AND BUG FIXES ARE EASILY INSTALLED 
AND DELIVERED 






p 



51 




'SOFTWARE; 




USTOMER J 



r 
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FUNCTION AND CONTROLLERS 

t THE BOOTSTRAP LOADER FUNCTION 

- LOAD THE RMX86 O.S AND APPLICATION SOFTWARE FROM 
SECONDARY STORAGE INTO RAM 

t SECONDARY STORAGE SUPPORT 

- THE RMX86 PRODUCT INCLUDE BOOTSTRAP LOADER DEVICE 
DRIVERS FOR THE FOLLOWING CONTROLLERS: 



V 



1) 


I SBC 204 


2) 


ISBC 208 


3) 


I SBC 206 


4) 


ISBC 215 


5) 


ISBC 218 


6) 


ISBC 254 
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STAGES 



*\ 



V 



• THERE ARE TWO PARTS TO THE APPLICATION LOADER 
- THE FIRST STAGE AND THE SECOND STAGE 
(ROM) (RAM) 



(RAM) 




• RUNS UPON SYSTEM RESET 

• FINDS DEVICE TO LOAD 
FROM 

• LOADS PART OF 2ND 
STAGE AND TRANSFERS 
CONTROL 



• FINISHES LOADING 
ITSELF 

• FINDS FILE TO LOAD 
FROM 

• LOADS FILE AND TRANSFERS 
CONTROL 



V 
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THE SECOND STAGE 

• A VOLUME MAY BE FORMATTED WITH THE HUMAN INTERFACE OR 
THE FILES UTILITIES. 

• THE FORMATTING PROCESS WILL PLACE THE SECOND STAGE ON 
THE VOLUME WITH NO EFFORT ON YOUR PART. 

• THE SECOND STAGE IS z 6K OF LTL CODE. 
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THE FIRST STAGE 
t THE FIRST STAGE CONSISTS OF TWO PARTS 

• THE FIRST STAGE RESIDES IN ROM 

• DEVICE DRIVER SOFTWARE (PART I) 

- SIZE DEPENDS ON HOW MANY DEVICE DRIVERS YOU CHOOSE 
TO INCLUDE. (EACH DRIVER 300 TO 500 BYTES) 

f BOOT LOADER CORE (PART 2) 

- THIS PART LOADS THE 2ND STAGE 

- SIZE DEPENDS ON HOW MANY OPTIONS YOU CHOOSE. 
(SIZE 100 TO 500 BYTES) 



r 
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(FIRST STAGE OPTIONS 

• THE LOCATION OF THE FIRST STAGE 

t THE LOCATION WHERE THE FIRST STAGE LOADS THE SECOND STAGE 

- (USUALLY IN THE FREE SPACE OF THE FINAL SYSTEM TO BE LOADED) 

• METHOD TO BE USED FOR DEVICE SELECTION 

- NO SELECTION 

- AUTO SELECTION 

- MANUAL SELECTION 

• METHOD TO BE USED FOR FILE SELECTION 

- LOADING A DEFAULT FILE NAME 

- ALLOWING THE END USER TO SPECIFY A FILE NAME 
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DEVICE SELECTION 

• NO SELECTION 

- BOOTSTRAP LOADER ALWAYS USES SAME DEVICE 

- IF DEVICE IS NOT READY, LOADER TERMINATES 

t AUTO DEVICE SELECTION 

- YOU PROVIDE A LIST OF DEVICES 

- THE LOADER CYCLES THROUGH THE LIST UNTIL IT 
FINDS A READY DEVICE 

t MANUAL DEVICE SELECTION 

- THE LOADER PROMPTS THE USER AT THE TERMINAL (*) 

- THE USER ENTERS A DEVICE NAME (E.G. :F0:) 

- IF NAME IS NOT FOUND THEN LOADER SWITCHES TO AUTO 
DEVICE SELECTION 



V 
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FILE SELECTION 
• THE LOADABLE FILE MUST BE A NAMED FILE 

t LOADING A DEFAULT FILE 

- THE DEFAULT FILE IS (/SYSTEM/RMX86) 

ff SPECIFYING A FILE NAME 

- DEVICE DELECT I ON MUST BE MANUAL 

- (E.G. : YES: LIFE/IS/HARD/IN/THE/FAST/LANE) 



V. 
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PROBLEMS 
WHAT IF: 

• I AM NOT USING ONE OF THE BOOTSTRAP DEVICE 
DRIVERS SUPPLED WITH THE RMX86 PRODUCT? 

t I DO NOT HAVE THE STANDARD 957B "TERMINAL" SUPPORT? 




WAIT— DON'T DO IT ! ! ! 

V / 



V 



WRITING YOUR OWN DEVICE DRIVER 

• A DEVICE DRIVER FOR THE BOOTSTRAP LOADER CONSISTS OF 
TWO PROCEDURES: 

- DEVICE$INIT AND DEVICE$READ 

• THE PROCEDURES MUST BE WRITTEN IN THE PLM86 URGE MODEL. 

• THE RMX86 LOADER REFERENCE MANUAL SUPPLIES MORE SPECIFIC 
INFORMATION ABOUT THESE PROCEDURES. 
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CUSTOM TERMINAL SUPPORT 

THERE IS INTEL PROVIDED SOURCE CODE (MODIFIABLE TO YOUR 
NEEDS) FOR TERMINAL COMMUNICATION SUPPORT. 

• YOU CAN ALWAYS WRITE YOUR OWN CODE. 



"\ 



INTEL 
CODE 




MY-OWN 
CODE 
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QUIZ! 
• I CAN CHOOSE ANY FILE NAME TO BE LOADED? T OR F 

WHAT IS THE MAX NUMBER OF DEVICES I CAN SPECIFY 
IN AUTO SELECTION? 

WHAT ARE POSSIBLE ERROR CAUSES IF BOOTSTRAP LOADER 
LOOPS IN 2ND STAGE? 



A 





pet 

HINT — LOOK IN THE LOADER MANUAL ! ! ! 
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